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WELCOME TO 
THE OFFICIAL 
PI] MAGAZINE! 


espite its small size, the Raspberry 

Pi is positively overflowing with 

possibilities. For hackers and makers 
it’s a blank canvas, easel, and palette rolled 
into one. While many are very happy to use 
it as the affordable computer it is, for most 
hobbyists it’s the key to unlocking a whole 
world of possibilities. Of course, you can’t 
paint a landscape without learning the basics, 
so — starting on page 16 — the newest member 
of the magazine team, Lucy Hattersley, shows 
you how to get to grips with world’s most 
famous credit card-sized computer. If you’re 
a new owner, or want to help a friend or 
relative, it’s a fantastic way to get started. 

When it comes to hacking and making, the 

sky is definitely not the limit, because in our 
feature starting on page 68 we show you how 
to emulate the very same computer systems 
that took us to the moon in the 1960s, with 
the out-of-this-world Apollo Pi project. 


Enjoy the issue! 


Russell Barnes 
Managing Editor 
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ANNOUNCES ITS 
POWERED BY PI 


The crowdsourced remote submarine project reveals 
that it’s controlled by a Raspberry Pi 3 


he Raspberry Pi has been 
used on land for robots, 
in the air for quadcopters, 
on the sea in racing yachts and 
drone boats, and there’s even a 


“Trident is a high-performance 
micro ROV (remotely operated 
vehicle) submarine that sends 
live video to a pilot at the surface 
who can control it,” explains Eric 


the Kickstarter went up and past 
$800,000 to ensure it was fully 
funded. While this may have 
been in November last year, it 
was only recently that the team 


couple in space right now as well. Stackpole, co-founder of OpenROV. revealed that a Raspberry Pi 3 was 
The Raspberry Pi is conquering The Berkeley-based startup makes the computer brain living inside 
everywhere but under the waves, open-source ROV submarines, the Trident. The Raspberry Pi 3 

in the murky depths. Now, this is and Trident is its latest project. came out after the Kickstarter 


all set to change. 


“Tts hydrodynamic design makes 
it optimal for penetrating through 


was funded, though, so why has 
it been used? 


Explore the depths with an ROV submarine 
powered by a Raspberry Pi 


The SS Tahoe sank in Lake 
Tahoe in 1940. What cana 
mini submarine discover 


about it? 
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in places that have 


“One of the main things 
we like about Raspberry Pi is 
its community,” Eric tells us. 


“Weve beena 


mazed by how 


The ghostly wreck of an ancient steamship lies 
120 metres down, on the bed of Lake Tahoe 


never been explored before. Trident 


will be the first ROV submarine 


that is affordable for the majority 
of consumers, and the aim of the 
project is to give people the ability 
to participate in a field they may 
not otherwise have access to.” 
The Trident project was 
Kickstarted in 2015, with an 
aim to be released at the end of 
2016. After asking for $50,000, 


many incredible devices have 
been built using Raspberry Pi, 
and we certainly hope Raspberry 
Pi developers will come up with 
creative projects on the OpenROV 
platform. The Raspberry Pi 3 also 
offered the best computationa 
performance, features, and form 
factor in our price range. We’re 
using the built-in WiFi on the Pi 
to communicate with external 


An intact porthole reflects the lights of the 
Trident as it creeps around this watery grave 


The prototype of the Trident is not much 
different from the finished design, with sleek 
curves that allow it to fly through the water 


payloads that can be mounted 
on Trident, and as time goes on 
we hope to develop software that 
uses advanced control systems, 
computer vision, and perhaps 
even machine learning to give 
Trident additional capabilities. 
We’ve even been talking 


One of the main things we 
like about Raspberry Pi 
1s its community 


wireless buoy to then connect to 
the controls. The tether can havea 


the Trident shouldn’t be going any 
deeper than 100 metres anyway. 

“Trident is only one step in our 
journey to popularise telerobotics 
as a tool for exploration,” says 


about ways to use software for 
autonomous operations.” 

The machine certainly looks 
impressive. Videos show it cuts 
neatly and quickly through 
the water, making sharp turns 
on a whim (see more here: 
magpi.cc/2baXRAf). It connects 
to the surface via a tether for 
better communication, using a 


Eric. “As we develop technology 
which will allow people to control 
vehicles through the internet 

and share data with thousands of 
others, we hope that we can not 
only change how many discoveries 
about our planet are being made 
each day, but also who the people 
making those discoveries are.” 
Find out more at openrov.com. 


An entrance into the SS Tahoe itself - watch 


you don't get the tether stuck, though door in the dark depths? 


range of up to 300 metres, although 


What's beyond this long-unopened 


The bare-bones motherboard connects to the Raspberry Pi 3 
at the front, which in turn controls much of the craft 


“Since the beginning, a major cornerstone of our 
company has been building community,” says Eric 
Stackpole. “Although Trident and most of our other 
hardware designs have chiefly been developed 
internally, we've found that sharing our work tends 
to create a stronger, more capable user base, and 
we hope it will also fuel more innovation in the 
field of low-cost underwater exploration. On the 
software side of things, there are a ton of open- 
source libraries and programs which we've used 
or modified, and we hope that our software will 

be useful to the community as well. We've put 
literally thousands of hours into developing our 
software and we want that to be a useful tool for 
others.” You can see the team’s open-source work 
on OpenROV's GitHub page: magpi.cc/2blGlof. 


Someone needs to clean their bathroom; 
no wonder the ship is abandoned 
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CREATE ALMOST 
ANYTHING WITH 


The all-inclusive hardware add-on for the Raspberry Pi 
hopes to open up the world to the tiny computer 


here are plenty of add- computer vision, and Internet of 
on boards and HATs for Things applications within minutes,” 
the Raspberry Pi that add explains Rodolfo Saccoman, CEO of 
eel Soalare ye Pet le) functionality to the computer, from AdMobilize, the company behind 
MeN outa Sel) simple things like LEDs or motor the MATRIX. “We see it as being a 
» FPGA (Xilinx Spartan 6) controllers, to sensor suites and building block for the democratisation 
» Microcontroller enterprise security. The MATRIX of oT and AI. Just as how the iPhone 
(ARM Cortex M3) Creator is something a little different, created an all-in-one hardware device 
» Temperature sensor though, adding a huge number that allowed developers to unleash 
~ Ultraviolet sensor of functions in a bid to open up their creativity and build amazing 
IP IAccurCccnsor development with the Raspberry Pito —_ apps, which in turn revolutionised 
oT and beyond. the world, we see the MATRIX Creator 
» 3D accelerometer : : ‘ : 
“The MATRIX Creator is an all- doing the same thing for a multitude 
mabgyioscope inclusive hardware device that of industries such as smart homes, 
> SENET connects to the GPIO pins on the intelligent buildings, robotics, 
» Humidity sensor Raspberry Pi and provides a means security, industrial control, smart 
» LEDs for any developer around the world retail, drones, custom maker projects, 
to start making machine learning, and many more.” 
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The MATRIX has many functions, including a multitude of sensors 
and microphones, as well as a ring of LEDs around the edge 


loT for all 

Rodolfo believes the MATRIX 

is something anyone can use. 
With this in mind, the team have 
created an operating system 
based on Raspbian, MATRIX 

OS, that allows people to start 
programming the MATRIX straight 
away in JavaScript. “MATRIX 
Creator is great as both a teaching 
and a development tool, aimed 


and have since been featured 

in magazines and websites. In 
addition, we completely sold out of 
our first batch of MATRIX Creators 
and since shipping them, we’ve 
had countless people on social 
media express their excitement 
about it and what they are going 

to use it for.” 
Even though the MATRIX sold out 
in June, it’s available to purchase 


The reactions have been 
incredible, truly surpassing 
our greatest expectations 


at anything from a middle school 
computer class to hobbyists and 
universities,” Rodolfo tells us. 

It’s taken a year to get this far in 
terms of development, and Rodolfo 
is delighted with the response to the 
board so far: 

“The reactions have been 
incredible, truly surpassing our 
greatest expectations! Since we 
aunched it at the National Maker 
Faire in June, we have received 
positive feedback and excitement 
from the community. While at the 
Faire, we won the National Maker 
Faire Editor’s Choice blue ribbon 


raspberrypi.org/magpi 


from the website; due to a lot 
of work from the team, they’ve 
managed to get the board priced 
pretty low at S99 (£76). You can 
find out more about it here: 
magpi.cc/2bisuQV. 
“Our small team is so humbled 
by the love we have received 
from the Raspberry Pi and maker 
community,” Rodolfo concludes. 
“Our goal is to develop a powerful 
and user-friendly creation platform 
for people to create amazing, 
intelligent things... we think 
machine intelligence and Internet 
of Things can be for everyone!” 


Here’s what people have 
already been making 


Balancing robots are those that work on just two 
wheels. This one runs about just fine, even with a higher 
centre of gravity. The accelerometers and gyroscopes 
in the MATRIX help make sure it stays balanced, thanks 
to a bit of extra code. 


magpi.cc/2biWfBa 


This one is quite simple but very effective: using the 
magnetometer on the MATRIX board, the Raspberry 
Pi determines a compass direction. This is then 
displayed on the board via the LEDs around the edge. 
It updates in real time. 


magpi.cc/2biXWP4 


Similar to the compass, this project uses a connected 
camera (attached to the middle of the MATRIX) to 
track the user's face. It uses this data to locate where 
the face is in relation to the MATRIX, and lights an LED 
that’s in that direction. 
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to boot from USB storage devices 
or load an operating system from 
an attached Ethernet cable 


t is now possible to boot a 

Raspberry Pi 3 from a USB 

storage device or directly 
from a network connection. 

These new boot modes enable Pi 

owners to start up Raspberry Pi 3 
devices with alternatives to the 
traditional SD card. The Pi can now 
be booted from an attached USB 


Network booting enables a computer to load all 

of its software over a network. This is useful ina 
number of cases, such as remotely operated systems 
or computers used in data centres. Network boot 
enables devices to be updated, upgraded, and 


completely re-imaged, without IT managers 


having to work manually on each device. r | 
It's now possible to use one Raspberry 

Pi with an SD card to load the operating 

system to other Raspberry Pis 

on the network. 
More information for 

network boot can be 

found in the Raspberry 

Pi documentation: 

magpi.cc/2aYArsw 


The Raspberry Pi 3 is now able 


BOOT 


New update makes it possible to boot from USB drives and networks 


storage device, such as a hard drive, 
SSD drive or thumb drive. You can 
even boot a Raspberry Pi without any 
storage device attached, by loading 
the operating system from another 
computer on the same network. 


The boot process 
“There’s a small boot ROM, which 
is an unchanging bit of code used 
to boot the device,” explains 
Gordon Hollingworth, Raspberry 
Pi’s director of engineering, in 
his blog on the Raspberry Pi site 
magpi.cc/2bdmnhy). “It’s the 
boot ROM that can read files from 
D cards and execute them. 
“When the Pi is powered up, 
or rebooted, it tries to talk to an 
attached SD card,” he continues. 
“{It] looks for a file called 
bootcode. bin; if it finds it, then it 
oads it into memory and jumps 
to it. This piece of code then 
continues to load up the rest of the 
Pi system, such as the firmware 
and ARM kernel.” 

The potential to boot to the 
Raspberry Pi was included at the 


ca) 


hardware level with the Raspberry 
Pi 3. “While squeezing in the 
quad A53 processors, I spent a fair 
amount of time writing some new 
boot modes,” reveals Gordon. 
“Needless to say, it’s not easy 
squeezing SD boot, eMMC boot, 
SPI boot, NAND flash, FAT file 
system, GUID and MBR partitions, 
USB device, USB host, Ethernet 
device, and mass storage device 
support into a mere 32kB.” 

He notes that this boot mode 
hasn’t been enabled by default, 
as they first wanted to check that 
it worked as expected. The boot 
modes are enabled in one-time 
programmable (OTP) memory, so 
you need to enable the boot mode 
on your Raspberry Pi 3 first. This is 
done using a config. txt parameter. 

Unfortunately, the new boot 
options are only available in the 
Raspberry Pi 3 — you can’t USB- 
or Ethernet-boot a Pi Zero or older 
models. “The boot code is stored 
in the BCM2837 device only,” says 
Gordon, “so the Pi1, Pi 2, and Pi 
Zero will all require SD cards.” 
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Mass effect 

There are lots of advantages to 
using a mass Storage device over 
an SD card. Hard drives, whether 
traditional spinning platter or flash 
storage, tend to be much larger 
than SD cards and storage space is 
much cheaper at high levels. 

The new boot mode makes it far 
easier for users to build projects 
that require large data storage 
without requiring both an SD card 
and hard drive. Flash thumb drives 
can be easily recycled into effective 
hard drives. Many users will find it 
easy to locate spare flash drives. 

There are some issues with 
using a USB mass storage device. 
“Some flash drives power up too 
slowly,” says Gordon, and “some 
flash drives have a very specific 
protocol requirement that we 


don’t handle; as a result of this, 
we can’t talk to these drives 
correctly. An example of such 

a drive would be the Kingston 
DataTraveler 100 G3 32GB.” 


USB AND ETHERNET BOOT 


But thanks to the sterling efforts 
of Raspberry Pi’s work-experience 
student Henry Budden, a list of 
working SSDs has been made: 
SanDisk Cruzer Fit 16GB, SanDisk 
Cruzer Blade 16GB, Samsung 32GB 
USB 3.0 drive, MeCo 16GB USB 3.0. 


Going Ethernet 
The benefits of network boot are 
less immediately obvious, but it’s a 
more intriguing technical process. 
“SD cards are difficult to make 
reliable unless they are treated 
well. They must be powered down 
correctly,” explains Gordon. “A 
Network File System (NFS) is much 
better in this respect, and is easy 
to fix remotely.” NFS file systems 
can be shared between multiple 
Pis, meaning that you only have 
to update and upgrade a single Pi. 
“T would like to thank my Slack 
beta testing team who provided 
a great testing resource for this 
work,” concludes Gordon. 
“Tt’s been a fun few weeks.” 


BUILD RASPBERRY PI POWERED ROBOTS 


WITH THE SB 


Directional LEDs 
cgi yee enntie Sica. aS | 
» Conneciors for an ultrasonic sens 
or f) Sees ook hei 8 
: Python library simplitying n 


MASS STORAGE BOOT 


The USB specification allows for a mass storage 
class which many devices implement, from the 
humble flash drive to USB attached hard drives. 
This includes microSD readers, but generally it 


refers to anything you can plug into a computer's 
USB port and use for file storage. 

You can find more information about the boot 
process for USB mass storage in the Raspberry Pi 
documentation: magpi.cc/2bmLYogn. 


MOTOR 
SHIELD 


when you pre-order 
before 19th August! 


hen I was young, watching 
motor racing with my 
father, I realised that most 
people were interested in who the 
best driver was, but I was interested 
in which car was the fastest.” 
So says Timothy Freeburn, who 
you may know as the director of 
PiBorg, the company that makes 
amazing Raspberry Pi robots and 
kits. “For me the competition was 
about the best engineering, not the 
best drivers.” 
With this in mind, Timothy and 
the PiBorg team have launched 
a Kickstarter for a brand new 
autonomous racing league, one 


FORMULA PI 


formulapi.com 


where engineering and software 
programming skills are the key to 
victory: Formula Pi. 

With a track built above PiBorg’s 
office, teams from around the world 
can enter by simply submitting 
their code for the race season, 
so they can be installed onto the 
special YetiBorg racers that have 
been built for the competition. 

“We set about designing a slower 
vehicle, one that could self-right if 
it got flipped over, and the YetiBorg 
was born,” explains Tim. “In order 
to keep the costs down, we use a 
Raspberry Pi Zero and camera on 
the YetiBorg, with our ZeroBorg 


FORMULA ~ 


The new robot racing series that teaches you about robotics 
as you live out your F1 fantasies 


motor controller. A 9V rechargeable 
battery powers both the motors 
and the Pi, and we’ve had running 
times on the track of 30 mins, so 
more than sufficient run time fora 
good race. The YetiBorg uses large 
wheels to give ground clearance 

on both sides; this makes for very 
entertaining ‘interactions’ between 
robots, as they very easily flip 

over when locking wheels with 

an opponent.” 

The Kickstarter will be over by the 
time you read this article, but fear 
not: if you want to enter and there 
are slots left, you’ll be able to do so 
on the Formula Pi website. 


e 
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contestants in Formula 


2 


A purpose-built, brightly 
coloured track atop the PiBorg 
offices will be used for the 
racing series. The colours and 
slower speed of the robots 
allow for the camera on the 
YetiBorg to do some image 
processing while navigating 
the course. 

Like all good race tracks, it 
has a tricky chicane along with 
a nice long straight and other 
gentler corners. The handling 
of the course will truly test the 
code's worth. 
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THE PI-POWERED 


Theo Lasers is looking to make cutting and engraving with light more accessible, 
and has turned to the Raspberry Pi to drive its open-source hardware 


Despite its low 

power requirement, 
the Theo Lasers cutter 
can easily create 
intricate cuts ina range 
of materials 


“When I gave up my job, the first thing | did was 
build the Microslice from end to end to see if it 
was pivot or persevere. | then made the Ultimaker 
Original, because that’s all the same sort of 

size and mechanics; they released that under a 
Creative Commons licence and they're still here,” 
explains Grant of his company’s beginnings. 

“I've learned from these guys, and | want to give 
something back to the community and makers. 
And that's where Theo is. | want to make a 
Kickstarter on this; | want to start the business, 


employ people, and get a premises in Glasgow 
where | live, but this is me giving back as well as 
launching my own business.” 
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gave my job up 18 months 

ago after volunteering 

in a makerspace,” Grant 
Macaulay explained from his stand 
at the Maker Faire UK event, where 
he was showcasing prototypes of 
education-centric laser cutters 
created by his startup company 
Theo Lasers. “Artists were coming 
in and cutting A4 sheets of paper 
n big industrial laser cutters, 
and I thought, ‘Right, ve been 
a maker, I’ve been making stuff 
under Creative Commons, I’m going 
to make a laser cutter with a laser 
cutter and give it all away with the 
plans, the grbl CNC tool, and an 
Android mobile phone app.’” 


o) 


The result: affordable, low- 
power laser cutters housed in an 
eye-catching laser-cut wooden 
chassis. Since their unveiling in 
April, Grant’s been hard at work 
with his team to improve upon his 
initial designs. “I wanted more 
from this laser cutter,” he says, 
four months on from his Maker 
Faire UK interview. “I dreamt of 
the full potential possible and 
what I as a maker was crying out 
for! I spent weeks banging my 
head against a brick wall, trying to 
get grbl to do what I wanted it to. 

t wasn’t working. 
“T phoned up my friend Gavin, 
who is an absolute genius at 
programming, and asked him to 
come and have a look and give 
me some guidance. He was so 
enthusiastic; he turned to me and 
said, ‘What do you want from me? 
That list will take me about eight 
hours!’ Fantastic! Far more than I 
could have possibly ever hoped for; 
what a morale booster!” 


Outgrowing its home 
Adding new features — including 
the ability to load files for cutting 
onan SD card, support for the 
RAMPS 1.4 CNC board from the 
RepRap project, a built-in display, 
Bluetooth connectivity, and 

even a temperature sensor for 
safety - soon meant the project 
was hitting the upper limits of 
the Arduino Mega on which it 
was based. Fortunately, there 
was a Solution readily available: 
the Raspberry Pi. 
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The attractive wooden housing - laser-cut, of course - hides sophisticated yet maker-friendly internals 


To keep costs down, the Theo Laser cutters use 
laser diodes rather than the more common carbon 
dioxide (CO,) filled tubes. Essentially the same 
technology as found in CD-ROM and Blu-ray 
drives, the laser diode runs at significantly lower 
power - 5W compared with 35W up to several 
hundred watts - and takes up less room thana 
tube-based laser. While this allows a Theo Laser 
to run entirely from battery power, it has an impact 


on efficiency: a Theo Laser may need to pass 


over material multiple times to make a clean cut, 
while the lowest-power 1W model is capable of 
engraving only. 


Theo Controller 

The shift from a microcontroller 
to a fully featured microcomputer 
opened up even more possibilities 
than Grant had first imagined. 
“We’ve now gone on to develop 
our own web service called Theo 
Controller,” he says, “which also 
allows for full photo engraving 


“We turned to the Raspberry 
Pi, and this opened up so many 
exciting possibilities and options,” 
Grant explains. “We immediately 
offloaded the peripheral devices 
— the SD card and display — and 
changed from an Android app and 
Bluetooth connectivity to browser- 
based software and WiFi.” 


to be controlled from any device 
with a web browser, the integration 
of the Raspberry Pi Camera Module 
allows for live yet safe viewing of 


The shift to a new control 
platform didn’t harm the freedom 
of the underlying hardware, which 
Theo Lasers is making available 
under a permissive open-source 
licence. “All the way through, we 
have kept backwards compatibility 


using several picture formats, and 
the progress can be monitored 
and recorded using the Raspberry 
Pi Camera.” 

It’s this which helps to truly set 
the Theo Lasers cutter apart from its 
competition. As well as the ability 


the cutting or engraving process. 
For devices which, even in their 
commercial incarnations, have 
been known to start small fires 
when the laser gets stuck, that’s 
something that adds real value, not 
to mention allowing for safer use in 


for Theo connectivity. Theo is fully 
grbl, OctoPrint, and Theo Controller 
compliant, accessible via USB, SD 
card, or WiFi connectivity. Theo 

can also be run from batteries 

and topped up by solar power, 
making Theo fully computer- 

and grid-free!” 


Theo Lasers 1s making the 
hardware available under an 
open-source licence 


education, where students can see 
the cutting process without risking 
their eyesight. 

At the time of writing, Grant and 
his team at Theo Lasers are planning 
to launch a Kickstarter campaign in 
early September for a trio of main 
models: a 1W entry-level engraver, 
plus 3W and 5W cutters. Regardless 
of the crowdfunding campaign’s 
success, all software and hardware 
is to be released under a permissive 
open-source licence. 


A Raspberry Pi Zero provides the brains for the clever Theo Controller platform 
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GETTING STARTED WITH RASPBERRY PI 


GD he Raspberry Piisa 
y wonderful microcomputer 
= that brims with potential. 
With a Raspberry Pi you can 

build robots, learn to code, and 
create all kinds of weird and 
wonderful projects. 

Hackers and enthusiasts have 
turned Raspberry Pi boards into 
fully automated weather stations, 
internet-connected beehives, 
motorised skateboards, and 
much more. The only limit is 
your imagination. 

But first, you need to start at the 
beginning. Upon picking up your 
Raspberry Pi for the first time, 
you’re faced with a small green 
ips and sockets and 
may have no idea what to do with 


eras ber 2016 


Creating amazing projects is easy with a Raspberry Pi, but first 
you need to plug it in and set up Raspbian, the default operating 
system. This guide will get you up and running in no time 


it. Before you can start building 
the project of your dreams, you’ll 
need to g 

keyboard, mouse, display, and 
operating system. 


mastered the basics. So in this 
guide, we’re going to take you from 
newbie zero to Raspberry Pi her 
Grab your Raspberry Pia 
get going. 
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GETTING STARTED WITH RASPBERRY Pl 


FQUIPMEN | 


YOU LL NEED 


MICRO SD CARD 


The micro SD card acts as the 
hard drive for your Raspberry Pi. 
You install the Raspbian operating 
system onto the card, then all your 
documents, files, and projects are 
saved to it as you work. 

Raspberry Pl fan Jeff Geerling did 
a community favour by purchasing 
over a dozen different micro SD 
cards and benchmarking each one. 
The results were pretty dramatic, 
with some cards running up to four 
times as fast as others. Samsung 


MagPi 


& ou don’t require much 

| to get your Raspberry Pi 
~~ started: a micro SD card 

from an old camera, a smartp 

charger, a recycled HD! le, 
and a keyboard and mouse are all 

you need. 

Most items can be sourced from 

computer hardware around the 

uae or es ida aa borrowed 


ige, and scavenge most 
equipment you need to get a 


Evo+ and SanDisk Extreme 

are two popular brands worth 
looking out for, and both are fairly 
cheap. You can read more at 
magpi.cc/2bncFs3 


All the kit you need to get a Raspberry Pi up 
ane running for the first time 


Regis) Pi up and running. 
To out of your 
Raspberry Pi in the long term, 
though, you should use high- 
quality components. 

icro SD card from 
rand will be faster 


ers are ee ve 


os aie ee i easier as store: 


There a Re ae oe cases 
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Discover the internet of your things 
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Click on the Wireless Networks icon Enter your WiFi password in the Test your internet connection by 

in the Panel. Raspbian will display Pre Shared Key field and click on opening a webpage. Click on Web 

a list of all the wireless networks OK. The network symbol will switch Browser in the Launch Bar and enter 

available in your local area. Click on to a wireless symbol and you'll www.raspberrypi.org in the URL 

the one that's yours. be connected. field. Press RETURN to load the page. 
ome DE, oasis 
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Connect wirelessly to nearby devices 
with Bluetooth technology 


luetooth is another 
piece of technology 
that has been added 
to the Raspberry Pi 3 board. 
With Bluetooth you can connect 
wireless devices, such as mice 
and keyboards, directly to your 
Raspberry Pi. 

As with wireless LAN, if you 
own an older Raspberry Pi 
model or a Pi Zero, you’ll need 
to attach a USB dongle to use 
Bluetooth devices. 

With Bluetooth hardware on 
your Raspberry Pi board, it’s easy 
to connect to a device wirelessly, 
a process known as ‘pairing’. 

You can pair wireless gaming 
controllers, like a PlayStation 
joypad, or Android smartphones. 
Many Raspberry Pi projects make 
use of Bluetooth, enabling the 
Raspberry Pi to communicate with 
nearby electronic components 
and devices. 

The easiest way to test out 
Bluetooth is to set up a wireless 
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mouse or keyboard; both are 
fairly easy devices to come by. 

In some ways, the process is 
similar to connecting to a WiFi 
network, but the Bluetooth device 
you want to connect to must be 
set to pairing mode first. This 
is also known as making the 
device ‘discoverable’. Putting a 
device into pairing mode varies 
by device; holding down the 
power button until an LED flashes 
is fairly commonplace, but 
check with the instructions for 
your device. 

You then use the Bluetooth icon 
in the Raspbian desktop Panel 
to connect to the device: choose 
Bluetooth > Add Device. 

It’s possible to put your 
Raspberry Pi into pairing 
mode by choosing Bluetooth > 
Make Discoverable from the 
Panel. Then you can connect 
to your Raspberry Pi from 
other Bluetooth devices like 
mobile phones. 


G UP 


SETTING UP 
A BLUETOOTH 
DEVICE 


Pairing mode 


Add new device 


Enter code 
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pi-top 


10 Hour 
Battery Life 


13:3" 
HD Screen 


Modular 
Components 


$2649 


without Raspberry Pi 
excluding VAT 


pi-top | 


Worldwide shipping available in green or grey at www.pi-top.com 
Stay up to date with our latest news by following our social media 


pi-topCEED 


Adjustable 
Viewing Angles 


14” 
HD Screen 


Modular 
Components 


$9999 


without Raspberry Pi 
excluding VAT 


Available in green or grey colours 


CEEDuniverse 


CEEDuniverse is a world of fantasy 
grounded in computing reality! After 
crash landing on a strange new planet 
you will first encounter ‘drag and drop’ 
coding puzzles that improve your 
computational thinking skills. 


Discover more about the planet you've 
landed on and the civilisation that used 
to inhabit it while learning harder and 
more complex concepts in fun and 
engaging ways! Before long you'll be 
writing your own conditional 
statements, loops and functions. Find 
out more about CEEDuniverse at 
www.pi-top.com 


pi-topCODER 


Influenced by the workflow of makers 
and hackers, pi-top presents 
pi-topCODER - an integrated code editor 
which allows you to learn, write and test 
code all in one view. With intuitive 
syntax highlighting, dynamic views and 
customizable themes it makes for a 
versatile learning tool for your projects. 


pi-topCODER also has every Raspberry Pi 
Foundation lesson plan created and will 
track and save your progress as you go 
through dozens of fun hardware and 
software projects. 


“ ‘ 
pi-topPROTO pi-topSPEAKER 
pi-topPROTO is a HAT compatible Give a voice to your pi-top device 
Add-on Board for your pi-top or with pi-topSPEAKER! 
pi-topCEED that allows you to 
prototype electronics. Create a e Modular design, attach up to three 
Weather Station, HAM Radio, Heart in a row to give true stereo sound. 
Rate Monitor, or integrate any « 2W per module 
Arduino based maker kits into your e Left, Right and Mono mix selection 
own Raspberry Pi compatible « High quality SPDIF digital audio 
prototyping board! from HDMI 
¢ 1?C controlled 
ent! » 


Our Official . — ae 
Distributors Sadat ruit a Y SCIENCE KIWI@Belec tronics ~— @S KUBII MODMYPI ‘MICO cence? S PrSnor.cn RS sparkfun. | 


ZERO 


Take 360-degree panoramas with 


With a 360° field of view, 


some clever Pi Camera Module these cameras can take 


complete panoramas 


placement and programming 


here’s always some new 
visual technology trying to 
break into the mainstream, 
whether it’s to try to improve the 
way we experience things or make a 
» There are eight bit of money. The quality, however, 
za ne varies wildly. At the moment, we’re 
ae entering a new age of virtual reality 
VR); this has created an interesting 
new set of visual experiences that 
has inspired James Mitchell. 


» The build took 
a few months 


» It currently 


only sees 52 


degrees of “Recently, there has been a 
vertical space rush of 360-degree VR videos 
» The Pi 3s online,” James tells us. “They’re 
actually power really impressive. Loving the 
Mi ABCA Sh technical side of photography and 
» James has the Raspberry Pi, it seemed only 
aoruee ogical that I would try and build 
pictures of 
the moon with something that would allow me 
a Pi camera to recreate those videos using the 
Raspberry Pi.” 


And so he did with the Zero360: 
a bank of Raspberry Pi Camera 
Modules arranged in a circle, 
connected to Pi Zeros. They can 
all take a photo at once; these are 
then stitched together to make a 
360-degree panorama. 

Why make it out of Pi Zeros, 
though? James explains that cost 
was a big factor: 


“The issue is that the equipment The final version has been This build uses a set of 
f ie Bod al : given a lovely red finish, Raspberry Pi Zeros (v1.3) 
Or Making 300- degree videos 1s perfect for a Pi project for the camera connector 


extremely expensive. Using the 
Raspberry Pi, it’s a fraction of the 
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The wood for the construction was 
laser-cut and was very easy to make, 
according to James 


cost. You could argue that the 
Zero360 is not really that cheap 
when you could use your mobile 
phone or even a DSLR camera, 
but those would only take a single 
still image and need a user to 
move the camera around, whereas 
the Zero360 can take stills from 
all angles at the same time and 
repeatedly. Those stills can be made 
into a time-lapse. Also, video is 
an option! These features don’t 
normally come that cheap!” 

The housing for the system 
was quick to make, once James 
had managed to procure enough 
Raspberry Pi Zeros; however, the 
code took a few weeks on and off 
to get working. Two Raspberry 
Pi 3s are also used in the project 
to stitch the image together, and 
the build is otherwise just made up 
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of Pi Zeros, Camera Modules, and 
power cables.“I’m using Raspbian 
Lite on all the Pis, with the raspistill 
and picamera Python libraries,” 
James explains. “I also managed 
to stitch the images on the Pi3 
using Hugin.” 
Aside from some issues 
with getting the networking 
going, the whole project i 
pretty straightforward. 
“Code-wise, there’s still a lot 
of work to do, sol can’t claim it’s 
doing what it does efficiently,” 
admits James. “But the final 
results are amazing! It’s especially 
cool that the images are stitched 
together on the Pi itself!” 
James has plenty of plans 
to improve the Zero360 in the 
future, so it can make even 
better panoramas. 


n 


ZERO360 


Projects 


MAKING A PANORAMA 
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The wooden box enables a better 
rumble effect than plastic or metal 
when the motor vibrates 


This strip of NeoPixels acts 
as a bar graph to indicate the 
magnitude of the earthquake 


EARTHQUAKE 


This clever box of tricks rumbles to alert you to earthquakes 


» Earthquake Pi 
took three days 
to build and 
program 


» It took longer 
to write the 
documentation! 


» The device 
checks for 
quakes every 
15 minutes 


» An electric 
toothbrush 
motor provides 
the rattle 


» Earthquake 
sounds are 
played through 
a speaker 


anywhere in the world 


ussell Grokett has 

been fascinated by 

earthquakes and geology 
ever since he was a child, when 
his father built him a simple 
swinging beam seismograph. 
However, since Russell now 
ives in Florida, known for 
hurricanes but not quakes, 
he’s created the Earthquake Pi 
magpi.cc/2aPNa62) to satisfy 
his interest. Rather than acting 
as a detector of local tremors, like 
some Pi-powered projects, it’s a 
neat alert system that uses real- 
time open data from the United 
States Geological Survey (USGS) 


Russell, “[but] I wanted to ‘feel’ 

(safely!) when an earthquake 

occurs. So came up with the idea 

of taking their data and building 

a device that rattles and rumbles 

when an earthquake occurs. 

This is different from the typical 

detection on a chart or graph.” 
The Earthquake Pi comprises 

a wooden box containing the 

electrical components, including 

a Raspberry Pi Zero and a vibrating 

motor recycled from an old battery 

toothbrush to make the box rattle 

during an alert: “I found that just 

loosely taping the motor down 

worked best, as it bounces around 


to detect earthquakes around 


the globe. 
“T had seen 
graphs of thel 
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fancy maps and 
r data,” explains 


a bit while running.” 
the effect, an externa 


To complete 
1 speaker 


plays earthquake sou 


nds, whilea 


strip of NeoPixels light up and an 


A 204 LCD display 
shows the details 

of the latest quake, 
including magnitude 
and location 


LCD display shows details of the 
seismic event. 

“By default, the vibrating motor 
alerts run for a few seconds per 
magnitude: about two seconds for 
mag. 1 and up to about ten seconds 
for a mag. 9 (never heard that, 
luckily!).” The LCD display and 
NeoPixel bar graph then come on, 
displaying the quake location and 
magnitude. Lastly, the earthquake 
audio sound effect plays for a few 
seconds more. “You just set the 
box on your desk or table where 
is sits quietly... until boom! 

The first few times it goes off 
will probably scare you, as it’s 
completely unpredictable!” 

Russell’s Python program 
includes a variable that can be 
set to the minimum magnitude 
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For the Pi Zero, an 
Adafruit l2S 3W 
Class D amplifier is 
required to supply 
audio to the mini 
external speaker 


The Earthquake Pi - without optional NeoPixel bar graph - 
showing an alert for a small quake in California 


for alerts. “If you set it to alert 
on even the smallest (magnitude 
1.0 or greater) earthquakes, then 
it will be going off almost every 
hour or so.” He tells us his is 

set to magnitude 3.0 and higher 


The first few times it goes off 
will probably scare you, as 
it's completely unpredictable! 


and goes off a few times per day. 
“When I hear it rattle, I run in 
to see where the earthquake is 
located. I especially perk up if I 
hear it rattle for many seconds, 
as that means a big one occurred 
somewhere. After watching it 
for a while, you do see a pattern 
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of where many earthquakes 
are occurring. It’s also a good 
geography lesson, as I’ve never 
heard of many of the cities or 
islands where they are, and 

so Il look them up on a map.” 


To ensure the Earthquake Pi 
doesn’t wake him during the 
night, Russell uses a cron job 
to only run the program between 
8am and 11pm: “You DO NOT 
want to run it while trying to 
sleep. It would probably scare 
everyone in the house!” 
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Projects 


THE TABLET 


» The Rebel 
Makers Club 
runs once 
amonth 


» Jonathan 
coded with the 
Adafruit Python 
MPR221 library 


» Jonathan used 
his mobile 
phone to 
record notes 


» The project was 
showcased 
in July 


» The Blue Flash 
Music Trust 
backed the 
project 


hen Robert Mayfair met 

eight-year-old James at a 

party in 1994, he gave him 
the gift of an ocarina. James was 
blind, and so thankful for the gift 
that he later contacted Robert and 
asked for lessons. A new bond was 
instantly formed between the two. 

Over the years of friendship, 

Robert and James have collected 
nearly 30 different instruments, 
with James’s love for music ever- 
growing, especially toward the 
ocarina. The joy of learning music 


Ocarina players Robert and James 
sought the help of teenager 
Jonathan to build an interactive 
touch tablet for reading music 


together, however, is often clouded 
by the inability to truly share the 
experience; resources are limited 
for the visually impaired. 
Recently, Robert discovered that 
the Royal National Institute of 
Blind People (RNIB) had published 
a Braille book of ocarina music, 
and though this was a wonderful 
advancement in accessibility for 
the visually impaired, Robert 
realised that sighted people 
were unable to interact with 
the content: 


“On buying the book I realised that 
the Braille book was of no use to the 
sighted person, as it was like looking 
at a landscape covered with snow.” 

Aiming to find a solution, Robert 
found his answer far quicker 
than anticipated when he came 
across a HackHorsham display in 
a shopping centre last November. 
The display, using pieces of fruit 
to produce music via conductivity, 
gave him the inspiration he needed 
to change the way he and James 
read music together. 


Split pins form the 
Braille symbols for 
each note of the song 


Crocodile clips consolidate 
each set of notes into one 
connection for the HAT 
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The Touch HAT detects 
the note pressed and 
plays a sound file 
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Wires connect each note together; As to As, Bs to Bs, and so on ee 


Robert produced a prototype of 
plastic and cardboard, and later 
brad nails, that James was able to 
interact with, recognising Twinkle 
Twinkle Little Star via touch. After 
a few alterations, a tablet was 
produced where nails formed the 
notes of the song in Braille, James 
reading them with one finger. 

In April this year, Robert 
attended The Rebel Maker Club, 

a monthly event hosted by 
HackHorsham, and met Jonathan 
Tyler-Moore. Jonathan already had 
experience of building with Pi and 
finding solutions for issues using 
tech. So it was no surprise when 
the 13-year-old quickly introduced 
a Piand speaker to the setup, 
allowing the appropriate note to 
be played aloud as split pins were 
touched on the tablet build. 

Each split pin is wired, with sets 
of notes connected together. All A 
notes, B notes and so on are then 


connected via crocodile clips to 

an Adafruit Capacitive Touch HAT. 
Touch an A note on the board, and 
the HAT recognises the connection 
and tells the Pi to play the 
appropriate sound. Jonathan used 
an ocarina to record each note onto 
his mobile phone, later copying 
them to the Pi as OGG files. 

The build was a success; James 
and Robert now have access to the 
technology that will allow them to 
learn music together, through both 
touch and sound. 

The project was finally 
showcased at the HackHorsham 
event at the Capitol Theatre 
in July, receiving praise from 
musicians and educators alike. 
Backed by the Blue Flash Music 
Trust, acommunity-based music 
charity within Horsham, the Tablet 
Ocarina Project is still a work in 
progress and a promising Starting 
point for a broader scope of builds. 
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Robert Mayfair demonstrates the 
touch functionality of the tablet 
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The TORUS is mounted 
high up so the clubbers 
can see it in action 


assembled, 
it measures 
two metres 
in diameter 


» In geometry, a 
torus is a circle 
rotated around 
an axis 


» TORUS's 
Fadecandy 
controls eight 
NeoPixel 
LED strips 


» The TORUS 
features 400 
LEDs in total 


» TORUS is 
painted white 
to reflect 
projected film 


Behind the blades sit a 
Raspberry Pi and Fadecandy 
board. These control the 
NeoPixel LED strips and are 
connected to the DJ booth using 
a50-metre Ethernet cable 


Nineteen interlocking blades 
are cut from MDF to create the 
unique shape 


VISUAL MUSIC INSTALLATION 


Amsterdam club nights look incredible thanks to this TORUS, 
a Raspberry Pi-controlled visual art sculpture 


msterdam is famous for 

its party scene, but The 

Netherlands is alsoa 
high-tech hub with lots of creative 
people working in science and 
computer technology. 

At the end of the week the Dutch 
like to party, and Amsterdam’s 
clubs are full of high-tech 
audiovisual treats. 

TORUS is a music installation 
piece created by Dutch visual 
artists Ridwan Nasruddin and 
Guust van Uden. It’s a large 
sculpture based on the torus 
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geometric shape, covered in 
hundreds of LEDs all controlled 


by a Raspberry Pi. 


“TORUS started as a research 


project,” explains Ridwan. 


“We were already doing visuals 


during club nights ona fla 


t white 


screen, but we wanted to create 


a sculpture. 


“We are interested in ori 


gami 


shapes and modular forms,” he 


continues. “We stumbled 


upon the 


paper art of Yoshinobu Miyamoto 


[a Japanese architect]. Ins 


pired by 


his art, we created the TORUS.” 


Built from 6mm MDF 
plywood, TORUS comprises 
18 blades assembled ina 
circular pattern. The blades are 
covered in NeoPixel LED strips 
(adafruit.com/category/168), and 
the whole unit mounted in a dance 
club alongside a projector. 

The LEDs are controlled using an 
Adafruit board called Fadecandy. 
This is a NeoPixel driver with built- 
in dithering, that can be controlled 
over USB. “We tried different ways 
to control the LEDs,” says Ridwan, 
“and found out Fadecandy was 
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TORUS 


Projects 


TORUS lights up Amsterdam's De 


Marktkantine club with its blend 
of film projection, light, and sculpture 


the best way to send the signal 
from Resolume (resolume.com) 
to the Raspberry Pi and then 
to the LEDs.” 
The Raspberry Pi is connected by 
a50-metre Ethernet cable, used 
to send the signal from Resolume 
(running on a laptop) to the Pi. 
“Because we didn’t knew a lot 
about how to connect LEDs to 
Resolume, we researched and 
experimented a with different 


We always wanted to make 
the experience of the music as 
intense as possible 


boards and types of LEDs. We 
thought we could learn it quickly, 
but when we couldn’t figure it out 


we asked around and found Nathan 


Marcus, a local programmer.” 
Nathan wrote the major part of 
the code and with his help, they 
learned how to create the image 
they had originally envisaged. 
The Raspberry Pi was added 
to get the LED data over a long 
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distance, of about 50 metres. 
“We had already settled on using a 


Fadecandy because of it capabilities 


and ease of use,” explains Nathan. 
The Raspberry Pi functions like a 
server connected over Ethernet 
with the laptop. It interprets the 
messages from the laptop and 
sends them to the Fadecandy. 
“We had a lot of help from the 
guys of the club [De Marktkantine 
in Amsterdam] where we showed 


the TORUS.” To hang the TORUS 
where everyone could see it, 
they used steel cables to make a 
hanging truss above the stage. 
“The reactions of the crowd are 
great. We always wanted to make 
the experience of the music as 
intense as possible and it works. 
By creating one focus point, 
people really get into the vibe 
of the club night.” 


BUILDING A TORUS 


> a WN 


>STEP-02 


>STEP-03 _ 
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NESPI 


The cartridges 
contain 
NTAG216 

NFC tags 


The reset 
button is 
used to send 
commands 
to the 
Raspberry Pi 


It runs RetroPie 
with Python 

code to control 
the NFC reader 


It's 40 percent 
of the size of 
the original NES 
Mike is 
designing a 
SNES next, 

and then 
maybe an N64 


MIKE GIBSON 


Mike is an electronics and 
3D printing hobbyist whose 
latest project is a miniature 
NES games console. 
daftmike.com 


We have a new king of retro consoles, thanks to NESPi. 
It doesn’t just look like a NES: it runs mini cartridges 


T 


grew up with the NES 
and have really strong 
memories of playing it 
with my brothers,” says Mike, the 
creator of NESPi, one of the most 
realistic retro console recreations 
we’ve seen. 
NESPi started out as an attempt 
to 3D-print a replica NES case. 
“Tt?s 40 percent the size of a real 
NES,” Mike tells us. “It wasn’t 
until I was a little way into 
researching cases that it turned 
into more than a replica project.” 
After buying a 3D printer 
on impulse and downloading 


The buttons are linked to the 
Raspberry Pi (via an Arduino) so 
the device can be switched on 
and off like the original NES 
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and printing a few trinkets, he 
decided to make something a bit 
more substantial. 

“Td seen people build Raspberry 
Pis into original full-size NES 
cases, but I always thought that it 
was a Shame there was so much 
wasted space. Part of Raspberry 
Pi’s appeal comes from its small 
size; that’s why I wanted mine to 
be as small as possible. 

Mike took measurements from 
the real thing and tried to replicate 
it as best he could. 

“The colour of the plastic I used 
also has a big role in making it look 


NFC tags are attached to the 
cartridge. When the carts are 
inserted, the Raspberry Pi loads 
up the corresponding game 


real. I researched a lot of filament 
suppliers before I found one that 
matched the shades correctly.” 
Mike used the Monotone 
Mix Pack from Faberdashery 
(faberdashery.co.uk). 
The NESPi goes way above 
and beyond most console 
reproductions by featuring mini 
cartridges to load games. These 
are inserted into the NESPi, which 
detects them using an NFC chip. 
“The NEC reader I used is based on 
the PN532 chipset,” says Mike. 
“The game is stored on the SD card 
in the Raspberry Pi, which is because 


The case and controller 
are built to scale, and 
all the parts move and 
work just like an original 
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The finished result is spectacular, looking 
and working just like a NES in miniature 


of the very small capacity of NEC. I 
used quite large tags, and they had 
just 888 bytes available to the user.” 
The NFC tags themselves only 
contain file name information; 
when the Raspberry Pi reads it, 
it looks up which game to run. 
“The cartridges are 3D printed,” 
says Mike. “I designed them in 
the same way as the case.” He also 


NESP1 goes way above and beyond 
most console reproductions by 
featuring mini cartridges 


printed little labels and covered 
them with sticky tape to get the 
right glossy look. 

“The great thing about 3D 
printing is once your printer is set 
up and tuned properly, you can get 
very consistent results. | learneda 
lot about designing for 3D printing 
from this project.” 

Mike tells us the carts load very 
well. For extra authenticity, when 
the project was mostly complete, 
he added a cute little controller. 
After mocking up a 40 percent 
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scale NES controller, he printed an 
empty shell, and the Arduino Pro 
Micro board fit inside perfectly. 
He notes that while the tiny 
controller is fully functional, it’s 
only really for display purposes: 
in practice he uses a Wii U Pro 
controller or Xbox joypad. 

Mike is delighted with the 
finished project. “It looks very 


cool; inserting a cartridge and 
clicking it down instantly makes 
me nostalgic for my childhood. 
I have a lot of fun playing with it.” 
Reactions to the NESPi have also 
been very positive. “People love 
seeing it. Everyone likes the little 
cartridges, even those who were 
too young or don’t remember the 
NES think it’s really cute. Those 
that do remember go crazy when 
I show them how the cartridges 
work. Suddenly they’re ten years 
old again: it’s so funny.” 


The controller 
contains a 
Arduino Pro 
Micro and 
works just like 


the original 


NESPI 


Projects 


BUILDING 
A MINI NES 


>STEP-03 
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ESSENTIALS 
LEARN | CODE | MAKE 


AVAILABLE NOW: | 


> CONQUER THE COMMAND LINE 


The 


> EXPERIMENT WITH SENSE HAT 
> MAKE GAMES WITH PYTHON 
> CODE MUSIC WITH SONIC PI 


i From the makers of the 
official Raspberry Pi magazine 
Ma 


OUT NOW IN PRINT 


JNLY £3.99 
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Tutorial 


ON YOUR PI 


Use Amazon’s Alexa service on a Raspberry Pi 
and open up a world of voice-control projects 


> Alexa AVS 
magpi.cc/ 
2boDnjB 


> Aconstant 
internet 
connection 


> External speaker 


> AUSB 
microphone 


n the UK, all the Star Trek shows have just 

been put back on Netflix, reminding us of 

the desire to ask the computer for Earl Grey 
tea or Klingon coffee (we can’t start the day without a 
raktajino, you know). So it’s exciting to see Amazon’s 
Alexa is quite readily available on the Pi now. Let’s get 
it working, then, and make some projects. 


Speak into the 
mic and ask 
Alexa for things, 
like a song in the 
key of Gwitha 
fast tempo 


After analysing your 
request, Alexa will senda 
reply. It works like Google 


Now or Siri, mostly 


The client is on the 
Raspberry Pi, but the 
heavy lifting is done 
in the cloud 
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ROB ZWETSLOOT 


Tinkerer, sometime maker, 

other-times cosplayer, and 

all-the-time features editor 
of The MagPi. 

magpi.cc / @TheMagP1 


We need to start by installing VLC. Not just normal 
VLC, though — we need to install this one slightly 
differently. Open up the terminal and enter: 


sudo apt-get install vlc-nox vlc-data 


This might take a while; once its done, we then need 
to set the environment variables so we can access VLC 
from Alexa properly later. Do this with: 


export LD_LIBRARY_PATH=/usr/1ib/vic 
export VLC_PLUGIN_PATH=/usr/1lib/vlc/plugins 


Next, it’s time to download the Alexa files we need: 


git clone https://github.com/amzn/alexa-avs- 
raspberry-pi 


Now we need to install our dependencies: Node, 
JDK, and Maven. In the terminal, enter: 


curl -sL https://deb.nodesource.com/setup | sudo 
bash - 


And let it work. It will end by prompting you to 
install Node.js. Do that with: 


sudo apt-get install nodejs 


Next, use cd to move to /alexa-avs-raspberry-pi/ 
samples/companionService and install npm with: 


npm install 


Once that’s finished, we need to then installa 
specific version of the Java Development Kit (JDK). Use 
cd to move to the alexa-avs-raspberry-pi/samples/ 
javaclient folder and run: 


./install-java8.sh 


You will get a message from Oracle Java installer 
that you must accept the terms of service for the 
Java SE platform, which you need to now do. 

Once that’s complete, download Apache Maven 
from magpi.cc/2bDPluf. Move to the Downloads 
folder and extract the contents with: 


sudo tar xvf apache-maven-3.3.9-bin.tar.gz 
-C /opt 


You then need to create a file with some system 
settings for Maven. Start by creating the file like so: 
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sudo touch /etc/profile.d/maven.sh 
sudo nano /etc/profile.d/maven.sh 


Add the following to the file you just opened: 


export M2_HOME=/opt/apache-maven-3.3.9 
export PATH=$PATH: $M2_HOME/bin 


Save and exit the file. Reboot your Raspberry Pi 
before continuing. 


Certification 


We now need to generate self-signed certificates: 
sudo apt-get install openssl 


Once installed, move back to /alexa-avs-raspberry- 
pi/samples/javaclient and run the script: 


./generate.sh 


It will ask you to enter some information. Enter the 
following details exactly as shown: 


Product ID: my_device 
Serial Number: 123456 


Just press ENTER when it prompts you for a 
password and then let it run and generate a key. 

Now we can get our details for the Alexa Voice 
Service; this does require an Amazon account, though. 
Go to developer.amazon.com and log in —- we then 
had to ‘complete’ our registration before continuing, 
so be prepared to do so as well. 

Once you’re at the dashboard, click on the Apps & 
Services tab, then Alexa. On Alexa Voice Service, hit 
Get Started. From the drop-down menu ‘Register a 
Product Type’, select Device. 

On the first page, fill in Device Type ID as 
my_device and Display Name with My Device. Click 
Next to go to the security profile. Click on the Security 
Profile drop-down and choose ‘Create a new profile’. 

Enter the following: 


Security Profile Name: Alexa Voice Service 
Sample App Security Profile 

Security Profile Description: Alexa Voice 
Service Sample App Security Profile Description 


Click Next and your Client ID and Client Secret will be 
generated for you. Go to the Web Settings tab and make 
sure the security profile you just created is selected in 
the drop-down menu, then click the Edit button. 

On Allowed Origins, click Add Another and 
then enter https://localhost:3000 in the text field 
that appears. For Allowed Return URLs, enter 
https://localhost:3000/authresponse and then click 
on Next. We’re now on Device Details; first set the 
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VOICE CONTROL ON YOUR PI 


Category as Other. 
Use a description 
of ‘Alexa Voice 


Service sample mete coed Sis 
app test’ and —=—? se " 
then choose —— sore 

‘Longer than 4 

months / TBD’ 


for the expected 

timeline question. 

Finally, enter o for for the number of devices you plan to 
commercialise and hit Next once more. On the next tab, 
click for Amazon Music and hit Submit. You’re done! 


Final configurations 
In a browser, go to magpi.cc/2bvWrNu. At the top of 
the page, select the security profile we created and 
click Confirm. You’ll need to enter a dummy web 
address for the consent privacy notice URL. 

Click Save. Click on Show Client ID and Chent Secret 
and make a note of them. 

Back on the Pi, move the alexa code folder to the 
Desktop and rename it alexa-avs-raspberry-pi- 
master. In the terminal, open the following file: 


nano /home/pi/Desktop/alexa-avs-raspberry- 
pi-master/samples/companionService/config.js 


Post your Client ID and Client Secret in the fields 
clientID and clientSecret respectively, and then save 
and close the file. 

Now we can get the Alexa service running. Start in 
the terminal with: 


cd /home/pi/Desktop/alexa-avs-raspberry-pi- 
master/samples/companionService 
npm start 


Open a new terminal window. Move to alexa-avs- 
raspberry-pi-master/samples/javaclient and use: 


mvn install 
It will say ‘build success’ when done. Run it with: 


mvn exec:exec 


Talk to me 
A window will pop up asking you to register the device. 
Copy the URL into a browser and log into Amazon, and 
click Okay on the next page to confirm everything. You’ ll 
be redirected to a page saying ‘device tokens ready’. 
Click OK on the original pop-up and you can start 
asking Alexa stuff. Hit the Start Listening button, wait 
for the audio cue, then ask it something like ‘what is 
two plus two’. Hit Stop Listening and it should reply 
‘four’. And that’s it, you’re ready to play with Alexa! 


Above You'll need 


to set up the app 
on your Amazon 
developers 
page, which is 
linked to your 
Amazon account 


ADAPTED 
FROM 


This tutorial 
was adapted 
from this 
excellent 
tutorial 

by Akash 
Chandran: 
magpi.cc/ 
2bljvC2 


ALEXA 
CONTEST! 


Join the 
Internet 
of Voice 
challenge 


and create an 


amazing way 
to add Alexa 
to a Pi project. 
Find out 
more here: 
magpi.cc/ 
2baErdf 
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Tutorial 


—— 
Wastebasket 


v 
S 


void main (void) 
{ 
int a = 0; 


if (a == 0) 


©ONOUSLWNeY F 


printf (“a is equal to O\n"); 
ll else 
{ 


printf ("a is nor 


A simple if-else structure 
in C, making a decision 
based on the value of ‘a’ 


When you type a closing 
bracket in Geany, the 
corresponding opening 
bracket is highlighted to 
help avoid errors 


AN INTRODUCTION TO C 
CONDITIONS & COMPARISONS 


Branches and loops: controlling the flow of your C program 


CURLY 
BRACKETS 


Curly brackets 
are used 

to group 
together a set 
of statements 
which always 
execute 
together. If 
your loop or 

if statement 
only needs 

to execute 
one single 
statement, 
you can leave 
out the curly 
brackets after 
the test, but 
this can make 
the code's 
purpose less 
obvious to 

a human! 
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ne of the fundamentals of any programming 

language is the ability to make conditional 

operations — to change the program’s flow 
depending on the result of a test - and C allows you to 
do this. In this instalment, we’ll look at how you test 
conditions within your C programs, and how you use 
the results to determine what happens next. 

In C, the mechanism for controlling flow based on 

testing a condition is the if-else statement. Here’s a 
simple example: 


#include <stdio.h> 


void main (void) 


{ 
int a = @; 
if (a == @) 
{ 
printf ("a is equal to @\n"); 
; 
else 
{ 
printf ("a is not equal to @\n"); 
i 
} 


Here, the keyword if is followed by a test enclosed 
in round brackets, in this case (a == @). If the test 
evaluates as true, the operations enclosed by the curly 
brackets after the test are executed. 
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This example also shows the use of an else clause. 
At the end of the curly brackets around the operations 
which you want to execute if the test is true, there 
is an else followed by another set of curly brackets, 
which contain the operations you want to execute if 
the original test evaluated as false. 

Try compiling the code above, and change the value 
with which a is initialised to make sure it does what 
you expect. 


=or== 
That’s all fine, but what’s thisa == @all about? 
Surely if we want to know whether a is equal to 0, we 
just puta = @. Why the two equals signs? Well, try 
replacing the double equals sign with a single equals 
and see what happens. 
This is a very important aspect of C syntax, 
and acommon source of bugs. The equals sign 
is used for two different things: one is to assign 
a value to a variable, whereas the other is to test 
whether a variable is equal to a value. A single equals 
sign (=) assigns a variable; a double equals sign (== 
tests a variable. 

So the statement... 


if (a == @) 


...tests to see if a is equal to o. If it is, then the test 
evaluates as true, and the code immediately after the 
if is executed. 

But the statement... 


raspberrypi.org/magpi 


if (a = @) 


...doesn’t compare a against 0 at all: it just sets a to o. 
So how does the compiler decide what to do next? In this 
case, it just looks at the value of what’s in the brackets; 
you’ve set a to 0, so the value inside the brackets is 0. 

In C, a value of 0 is equivalent to false, and a non- 
zero value is equivalent to true. So by replacing the 
double equals with a single equals, you’ve changed 
the value of a, and then you look to see if the value 
you’ve set a to is equivalent to true or false; neither of 
which were what you wanted to do! If aC program is 
behaving strangely, check very carefully that all your 
tests are actually tests and not assignments: this is a 
very easy mistake to make. 

So == is the test to see if a value is equal to another 
one. There are other useful symbols that can be used in 
atest. The symbol !=, for example, means ‘is not equal 
to’. The mathematical operators > and < are used to test 
for ‘is greater than’ and ‘is less than’ respectively, and 
they can also be combined with an equals sign to give 
>= and <=, the tests for ‘is greater than or equal to’ and 
‘is less than or equal to’. 

You can combine tests with logical operators. The 
symbol && is a Boolean AND (i.e. test whether both 
sides are true), and | | is Boolean OR (i.e. test if either 
side is true). So, to execute code only if both a and b are 
0, you would use if (a == @ && b == @). Tocheck if 
either aor bis 0, youuseif (a == @ || b == @). 

Similarly, you can use the operator ! as a Boolean 
NOT to invert the result of atest, soif (!(a == @)) 
is the sameasif (a != @). 


Looping 

The if statement is useful for making a single decision, 
but what if you want to do something repeatedly until 

a test is true or falsee We use a while loop for this, and 
here’s an example: 


#include <stdio.h> 


void main (void) 


{ 


int a = @; 


while (a < 5) 
{ 
printf ("a is equal to %d\n", a); 
at++; 
} 
printf ("a is equal to %d and I’ve 
finished", a); 


} 


This is very similar to an if statement, but the code 
in the curly brackets is executed repeatedly for as long 
as the test in the round brackets is true, not just once. 
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AN INTRODUCTION TO C 


weid main (weid) 
it 


int # = 0; 
if (emo 
{ 


printf ("» is 


So in our example code, a is initialised to 0. We 
enter the while loop, and test to see if ais less than 
5, which it is, so the code inside the curly brackets is 
executed. The value of a is printed out, then we have 
one of C’s useful shortcuts to save too much typing... 

a++ is the same as a=a+1; the double plus means 
‘add one to this variable’. Similarly, a-- means 
‘subtract one from this variable’; these are very 
commonly used to count the times around a loop. 
The notation a+=1 can also be used to add a value 
to a variable; this also works for other arithmetic 
operators, so a*=3 multiplies a by 3, and so on. 

In the while loop, each time the code in the curly 
brackets has been executed, the test in the round 
brackets is repeated; if it’s still true, the loop code is 
repeated again. As soon as the test is false, execution 
continues with the line after the closing curly bracket. 

Sometimes, we might want a loop which always runs at 
least once before a test is made. We do this with a small 
modification to the syntax to create a do-while loop: 


#include <stdio.h> 


void main (void) 


{ 


int a = @; 


do 
{ 
printf ("a is equal to %d\n", a); 
at++; 
} while (a < 5); 
printf ("a is equal to %d and I’ve 
finished", a); 


} 


The keyword do now goes before the curly bracket, 
and the while and test go after the closing curly 
bracket. When this runs, the code in the loop always 
executes once before the test; you can test this 
by running both the loop examples above with a 
initialised to 5 rather than 0, and seeing how the 
behaviour differs. 

In the next instalment, we’ll look at some more 
complex examples of looping and flow control. 


Tutorial 


Left Make sure 
that you use a 
double equals sign 
in the brackets 
after the if, nota 
single one! 


ELSE-IF 


You can have 
multiple else 
statements 

in one test. 
Instead of 

one simple 
else for one 
alternative, use 
else if () 
with a new 
test for each 
alternative you 
want. We'll 
look more at 
this in the next 
instalment. 


INFINITE 
LOOPS 


Make sure your 
loops always 
finish! If the 
condition you 
test in a while 
loop never 
evaluates to 
false, your 
program will 
sit in the loop 
forever and 
never finish. 
Ifa program 
appears to be 
doing nothing 
when you run 
it, check your 
loop tests. 


MORE ABOUT 
SEMICOLONS 


Unlike the 

test in an if 
statement ora 
while loop, you 
need to puta 
semicolon after 
the test in a do- 
while loop. This 
indicates the 
end of the loop 
code; in a while 
loop, the loop 
code doesn't 
end until the 
last statement 
inside the 

curly brackets. 
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Tutorial 


Create hypnotic ribbon effects with this ribbon 
twirling simulator in honour of the Olympics 


You'll 
Need 


his month’s project, like last month’s, programming language, the language itself is quite 
a was inspired by the recent Olympic games. good. Basically, it’s an implementation of Java, and 
ee We’ve always liked the rhythmic gymnastics, Java is implemented with aC syntax. It’s a language 
especially the section with the ribbons, so we set much beloved by the artistic, creative community, and 
> 2x thumb . ; ‘ ; : : ‘i , 
joysticks off to recreate this on the Pi. This project is a bit of there are plenty of stunning examples of its use. We 
a departure from normal Bakery stuff, in that for used it for this project because there was already an 
> 13-by-10-hole . A : ‘ F 
stripboard the first time we switch languages from Python to excellent ribbon drawing class that makes the code 


Processing. While Processing is a strange name fora writing so much easier. 


> Wooden box 
(MDF) 


> 4x 145mm M3 
tapped pillars 


> 0.1UF ceramic 
capacitor 


> 8-way ribbon 
cable 


Ugh veneers ri eorresa Boman 


‘o-—- MOAMY? GNWSO SHE 


The ribbons are 
twirled around 
on the screen 


Two thumb joysticks 
are used to control the 
movements of the ribbons 


= 


o> 
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Raspberry Pi 
GPIO connector 


Left thumbstick 


GPIO 10 
GPIO 9 
GPIO 11 
GPIO 8 


0.1UF 


Gnd 


Right thumbstick 


The hardware 


The two ribbons are controlled by small thumb BUILDING THE 
analogue-to-digital converter (ADC). This is the 
cousin of the MCP3002 chip we used in the Spectrum 

Display and the Hairgrip sequencer of MagPi issues 

uses the same SPI software commands to interface bt | ~~ Vet le. Pa P* Pel te 
with it as the smaller chip. You could also use the Pa eet WN sale | Pe dele 
eight-channel MCP3008 if you like, and there are 1@| |\@| |@! |@! 1@| 1@ 1@| |e 1@| 


joysticks, and are read into the Pi with an MCP3004 

RIBBON CONTROLLER 
45 and 46. This chip has four analogue inputs, but 
a few pre-built Pi interfaces that use this chip. eal 


The schematic is quite simple and is shown above; ea 
we used the surface-mount version of the chip, \@ 
but through-hole chips are also available. Full ita ee ee 

construction notes for the through-hole chip are le! 
given in the step-by-step guide. e | e | 
The language ry 


As Processing has only recently been ported to the Pi, 
it’s likely you will need to install it; this is not complex 
but can take a little time. You can install it from the 


command line by typing: ie) \@| |e! 


curl https://processing.org/download/ fe es TN A i ts i 
install-arm.sh | sudo sh 


After a reboot, it will appear in the Programming >STEP-01 
section of the desktop’s Main Menu. The good news Prepare the board 
is that the Pi version of Processing has support 
for the GPIO pins built in; for this project we need 
to use the SPI port, so this needs to be enabled. 

These days this is easy to do: just open Raspberry Pi 
Configuration (under Menu>Preferences), navigate to 
the Interfaces tab, enable SPI, and then restart your quick to start, especially the first time, so you’ll need 
Pi. After installing Processing, you will find a folder to be a little patient. Have a look at the examples 
called sketchbook on the top level of your files; this found in the File menu; most work, although some 

is the normal place to put your Processing code. Start of the graphic demos don’t. One favourite of ours is 
up Processing from the Programming menu; it’s not — found at Topics>Fractals>Tree. 


a 14-pin socket to the other side of the board. 


Get a piece of 13-by-10-hole stripboard and cut the tracks as shown, 
with the view from under the board. There's just one IC on this board; 
the rest of the board is used to hold the input/output wires. Solder 
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The software 
Now take the blank program that came up on startup 
and save it as ‘ribbons’, then click the arrow next 

to the tab, select New Tab, and name it ‘MCP3004’. 
Make three more tabs and call them ‘Ribbon’, 


GPIOS 


GPIOT1 


QAR. 
U u,v 
UT paren | (heh ioe La Ua 


= Gs 


=) | O.1uf | le! le! | 


tc 
MCP3004 


ea 


= = 
| 


dl 


SUSU 
aes 


GPIO2 


sw 


GND 
SW 
Left Thumbstick 


Mounting the components 


uw 


Right Thumbstick 


GPIO 10 
GPIO8 
GND 


ie May ites 
TA ios ic ne 
—! |e! |e! 


1G a] 
~~) 


GPIO3 


sw 


Solder solid wire links between the holes as shown and fit the 0.1uF 
decoupling capacitor. Wire the two thumb joysticks to the board. Wire 
the connections to the Pi using a length of 8-way ribbon cable. We used 
a 26-way socket to plug onto the GPIO pins; that way it will work with all 


models of Pi. 


, 
= tee 2s 


TEP-03 


Construct the box 


The base plate is drilled with shallow holes to allow the Gorilla Glue 
to foam into them, and the sides glued on are made from 17mm strip 
pine. Make a top with two 25mm diameter holes for the joysticks and 
fasten to the base with tapped pillars. Make a small notch in the top 


side to allow the ribbon cable to come through. 
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‘RibbonManager’, and ‘RibbonParticle’. Now we’re 
ready to start filling these tabs with code, so we’ ll 
start with the pre-written classes. Go to the page 
magpi.cc/2aRvO9i, copy the code from the comment 
//==manager to //== ribbon, and paste it into the 
RibbonManager tab. 

Next, copy the code from //==ribbon to 
//== particle and paste it into the Ribbon tab. 

Finally, copy the code from //==particle to the 
end of the file and paste it into the RibbonParticle tab. 

Now for our code. Type the Ribbons.pde listing into 
the ‘ribbons’ tab and MCP3004.pde into the MCP3004 
tab. This last class was part of the Processing 
distribution, but it contained an error that took about 
a day to track down, make similar changes to the 
MCP3008 class if you want to use that. 

Now we need to make some minor changes to the 
RibbonManager class. Find the part of the file near the 
end that starts void setDragFlaire and after that 
line, type in the new method setNewColour found 
in the Change_colour.pde listing. 

The last tweak is in the Ribbon tab. Change: 

float radiusMax = 8; 

to 

float radiusMax = 12; 

One final thing to do is to take two JPEG images and 
save them in the ribbons folder of the sketchbook 
folder. These should be called swatch_01.jpg and 
swatch_02.jpg and are the images that will be used to 
generate the colours of the ribbons. Two random pixels 
are chosen from each for the colours. These are best as 
just tiny images, like a 16-by-16 pixel image of colours 
that go together, but any image file will do. 


Running the code 
Click the triangle in the top-left corner of the code 
window to run the code; it’s set up to run in full screen 
mode, although you can set a window size if you want, 
by commenting out the full screen and uncommenting 
the line below. The code will run faster in a small 
window than full screen. Note that in Processing the 
double slash // is the comment symbol. Moving the 
joypads will move the ribbon round the screen, and 
pressing on the joypad will click a switch and change 
the ribbon colour. 

All the code, ready to run and with two swatch 
images, is available in our GitHub repository. 


Taking it further 

There are lots of default parameters you can change 
about the ribbons, either in the Ribbon tab or when 
you instantiate the ribbon in the main ‘ribbons’ tab. 
For example, you can change the ribbon parameters of 
friction, gravity, dragFlare, and ribbonAmount. 
This last one controls the number of strands in 

a ribbon. Also, making small swatch images is a 

good way to change the colours in a way you like. 
Happy twirling! 
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Ribbons.pde 


// Ribbons by Mike Cook August 20 16 

// with credit to http://www. zenbullets.com 
import processing.io.*; 

MCP3004 adc; 


int ribbonAmount = 2; // number of ribbon strands 
int ribbonParticleAmount = 20; 

float randomness = .23 

RibbonManager ribbonManager1; 

RibbonManager ribbonManager2; 

float xPad1 = 0.120, yPad1 = 0.120; 

float xPad2 = 0.120, yPad2 = 0.120; 

boolean rightClick = false; 

boolean leftClick = false; 


void setup() 
{ 

fullScreen(); 

//size(600@, 450); 

frameRate (30); 

background(@) ; 

GPIO.pinMode(2, GPIO.INPUT) ; 

GPIO.pinMode(3, GPIO.INPUT) ; 

ribbonManager1 = new RibbonManager(ribbonAmount, 
ribbonParticleAmount, randomness, "“swatch_@1.jpg"); 


MCP3004.pde 


import processing.io.SPI; 
class MCP3004 extends SPI { 
MCP3004(String dev) { 


super (dev) ; 
super.settings (500000, SPI.MSBFIRST, SPI.MODE@) ; 


float getAnalog(int channel) { 
if (channel < @ || channel > 3) { 


System.err.println("The channel needs to be from @ to 


3m) 


throw new IllegalArgumentException( "Unexpected 


channel"); 
t 
byte[] out = { 8, 0, @ }; 
// encode the channel number in the first byte 
out[@] = (byte)(@x18 | channel); 
byte[] in = super.transfer(out) ; 


int val = ((in[1] & @x3f)<< 4) | ((in[2] & @xf@) >> 4); 


// val is between ® and 1023 
return float(val)/1023.0; 
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ribbonManager2 = new 
RibbonManager (ribbonAmount, 
ribbonParticleAmount, randomness, 
"swatch_@2.jpg"); 

adc = new MCP3004(SPI.list()[@]); 


void draw() 


fi11(@, 255); 
rect(@, @, width, height); 
doClick(); 


ribbonManager1.update(int(xPad2*width) , 
ribbonManager2.update(int(xPad1*width) , 


RHYTHMIC GYMNASTICS 


DOWNLOAD: 


PROJECT 
VIDEOS 


Check out Mike's 
Bakery videos at: 


magpi.cc/1NqJnTz 


xPad1 = @.5 - (adc.getAnalog(@)/2.0); 

yPad1 = adc.getAnalog(1); 

xPad2 = @.5 + (adc.getAnalog(2)/2.0); 

yPad2 = adc.getAnalog(3); 

stroke(255, 255,255); 

ellipse(xPad1*width, yPadi*height, 15, 15); 
ellipse(xPad2*width, yPad2*height, 15, 15); 


void doClick(){ 
if (GPIO.digitalRead(2) == GPIO.LOW && !rightClick) { 


print("right press "); 
rightClick = true; 
ribbonManager2.setNewColour(); 


if (GPIO.digitalRead(2) == GPIO.HIGH && rightClick) { 


println("release "); 
rightClick = false; 


if (GPIO.digitalRead(3) == GPIO.LOW && !leftClick) { 


print("left press "); 
leftClick = true; 
ribbonManager1.setNewColour() ; 


if (GPIO.digitalRead(3) == GPIO.HIGH && leftClick) { 


println("release "); 
leftClick = false; 


Change_colour.pde 


void setNewColour() { 


for (int i = @; i < ribbonAmount; i++) { 
int xpos = int(random(img.width) ) ; 
int ypos = int(random(img.height) ) ; 
color newColor = img.get(xpos, ypos); 
ribbons[i].ribbonColor = newColor; 
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>PROCESSING 3.1.1 


int (yPad2*height) ) ; 
int (yPad1*height) ) ; 
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Tutorial STEP BY STEP 


BUILD A CAR 
MONITORING SYSTEM 


Thinking about monitoring cars passing by? Prototype your own number 
plate recognition system with a Camera Module connected to your Pi 


Wyliodrin 
STUDIO 
magpi.cc/1Qsi4il 


SS441A 
Hall sensor 


220 resistor 
16x2 LCD 


Potentiometer 


Jumper wires 


Breadboard 


ver wondered how the systems monitoring the 
traffic flow work? This article will guide you 
through the first part of building a mock-up 
system that monitors cars passing by your Camera 
Module. By using a simple magnetic sensor, you can 
detect the presence of a magnet and display its traffic 
rate on an LCD, all by using a data flow approach 
which makes programming fun and intuitive. 


>STEP-01 

Connect the Hall sensor 

The SS441A sensor is a device that reacts to magnetic 
fields; its behaviour can be compared to that of a 
push button. The sensor outputs HIGH in the normal 
state and LOW when a magnet is near it. 


The Raspberry 

Pi needs to be 
connected to your 
network to be able 
to control it 


Connect the Hall 
sensor with the 
smaller side facing 
the Raspberry Pi 
board 


rm 
— 


We insert the sensor into the breadboard 
with the smaller side facing the board, then 
connect the right leg to the 3.3V pin, the middle 
one to the GND, and the left leg to a GPIO pin 
of the Raspberry Pi. 

We also need to connect the 220Q resistor between 
the 3.3V pin and the GPIO pin. Refer to the Fritzing 
diagram below for how to do this. 


>STEP-02 

Connect the LCD 

For the LCD, the first two pins on the right are used to 
power it up. The next four pins, the ones connected by 
green cables, are the four data pins, and finally there 
are two control pins. 
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) trigger & block 


> —. 3 | initcounter | 


—————— 


There are also three pins used for contrast. Two of 
them are used to power on the backlight and there’s 
one more pin directly connected to the potentiometer, 
which will output a different voltage depending on 
its angle. This way, we can control the contrast just 
by rotating it. Again, you can refer to the Fritzing 
diagram to make sure it’s wired up properly. 


>STEP-03 

Create a Node-RED application 

We will program the Raspberry Pi using Wyliodrin 
STUDIO. First, we must download the application 
(magpi.cc/1Q5i4il) and follow the steps to 
connect the Raspberry Pi. For more details on 
how to get started with Wyliodrin STUDIO, read 
the Pi thermometer article from issue 45 of 

The MagPi (magpi.cc/1rBnGgA). 

Once connected, we create a new Streams 
application, which allows us to write applications 
using Node-RED. This language is based on events; 
it uses nodes which are connected and transmit 
messages to each other. Once a node receives a 
message, it processes it and sends it forward. 


>STEP-04 
Initialise the LCD 
The first stream of nodes initialises the LCD 
connection. This stream needs to function only once. 
It starts with a run node which we double-click and 
set to Fire once at the start. Then, we drag the trigger 
node and set it to wait until reset. 

Next, the function node initialises the LCD. First 
of all, we must require the wyliodrin module. 


Edit function node 


> Name init LCD &~ 
# Function 


var wyliodrin = require (“wyliodrin"); 


context.global.lcd = new wyliodrin.LiquidCrystal 
context.global.led.begin(16,2); 
context.global.lcd.setBacklight (1); 

context .global.lcd.print("0"); 


NOUSWNH 


Above The init LCD function creates the global lcd object based 
on the pins the LCD is connected to, and prints 0 on the display 
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BUILD A CAR MONITORING SYSTEM 


é __ into 


Edit function node 
> Name printon LCD a~ 
# Function 


1 if (msg.payload === 0) 
{ 


console. Log(context.global. count) ; 

context .global.count++; 

context. global.tcd.clear(); 
context.global.lcd.print(context.global.count.toString()); 


} 


ky oauvewn 


Edit trigger node 


Send the string payload via 


then wait to be reset ’ 


Afterwards, we call the LiquidCrystal constructor, 

which gets the following pin numbers as parameters: 

RS, Enable, D5, D6, D7, and D8 (the four data pins). 
Finally, we call begin and setBacklight 

and the LCD is ready to be used. 


>STEP-05 

Display the number of cars 

The second stream of nodes runs every 10 

minutes, Fires once at the start, and sets 

context .global.count to o. Any variable prefixed 

by context. global can be accessed from any node. 
For the third stream, we set the run node to send 

a message every 0.1 seconds and activate the digital 


read node, which reads the value coming from pin 23. 


We only want to take into account the changes in the 
system, which is why we use the rbe node. 

Finally, we implement the ‘print on LCD’ function 
which verifies if the value read is 0, increases the 
counter, and displays the value on the LCD. 


>STEP-06 


Count the cars 


All that’s left to do is to run the code and simulate the 


passing cars by bringing a magnet towards the Hall 
sensor. To create a system that really monitors the 
traffic, the Hall sensor needs to be replaced by a coil 
which is usually located under the pavement. 

In the second part of the tutorial, we will take 
a picture of the cars passing by and use a web 
service to identify the number plate. Look out 
for it next month! 


Tutorial 


qanguage 


>STREAMS 
(NODE-RED) 


DOWNLOAD: 
magpi.cc/2aOCfqD 


Left The print LCD 
function verifies 
the incoming value 
and if the value 

is 0, increases 

the counter and 
displays the 

new value 


Left The trigger 
node is set to 
wait to be reset 
before sending 
another message 
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Tutorial 


1))) Sonic Pi 


rIVE 


Wave your hands in the air with Sam Aaron and get the party jumping as you live-code 


Raspberry Pi 
running Raspbian 


Sonic Pi v2.9+ 


Speakers or 
headphones with 
a 3.5mm jack 


Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi 


Below Sam Aaron 
and Ben Smith 
performing at 


Cambridge Junction 


as Poly Core 


n this month’s tutorial we’re going to take a 
look at how you can start treating Sonic Pi like 
areal instrument. We therefore need to start 
thinking of code in a completely different way. Live 
coders think of code in a similar way to how a violinist 
thinks of their bow. In fact, just like a violinist can apply 
various bowing techniques to create different sounds 
(long slow motions vs short fast hits) we will explore 
five of the basic live-coding techniques that Sonic Pi 
enables. By the end of this article, you’ll be able to start 
practising for your own live-coded performances. 


Memorise the shortcuts 

The first tip to live-coding with Sonic Pi is to start using 
the shortcuts. For example, instead of wasting valuable 
time reaching for the mouse, moving it over to the Run 
button and clicking, you can simply press ALT andR 

at the same time, which is much faster and keeps your 
fingers at the keyboard, ready for the next edit. You can 
find out the shortcuts for the main buttons at the top by 
hovering the mouse over. See section 10.2 of the built-in 
tutorial for the full list of shortcuts. 

When performing, one fun thing to do is to add a bit of 
flair with your arm motion when hitting shortcuts. For 
example, its often good to communicate to the audience 
when you’re about to make a change - so embellish 
your movement when hitting ALT+R, just like a guitarist 
would do when hitting a big power chord. 
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a) OF 02 OF 84 05 06 07 OF OP 30 2) 12 4 3 
7 pat = (1, 0, 0, 0, 1, % 9 % 8 % i, % 6, 9, @, o 


play 142, release: 0.2, amp: ? 


somo éren 
sleep 0.125 
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Manually layer your sounds 

Now you can trigger code instantly with the keyboard, 
you can apply this skill for our second technique, which 
is to layer your sounds manually. Instead of ‘composing’ 
using lots of calls to play and sample, separated by 
calls to sleep, we will have one call to play which we 
will trigger manually using ALT+R. Let’s try it. Type the 
following code into a fresh buffer: 


synth :tb3@3, note: 
cutoff: 90 


:e2 - @, release: 12, 


Now, hit Run and whilst the sound is playing, 
modify the code in order to drop down four notes by 
changing it to the following: 


synth :tb3@3, note: 
cutoff: 98 


:e2 - 4, release: 12, 


Now, hit Run again, to hear both sounds playing at 
the same time. This is because Sonic Pi’s Run button 
doesn’t wait for any previous code to finish, but 
instead starts the code running at the same time. This 
means you can easily layer lots of sounds manually, 
with minor or major modifications between each 
trigger. For example, try changing both the note: and 
the cutoff: opts and then re-trigger. 

You can also try this technique with long abstract 
samples. For example: 


sample :ambi_lunar_land, rate: 1 


Try starting the sample off, and then progressively 
halving the rate: opt between hitting Run, from 
1 to @.5to@.25 to@.125, and then even try some 
negative values such as -@.5. Layer the sounds 
together and see where you can take it. Finally, try 
adding some FX. 

When performing, working with simple lines of code 
in this way means that an audience new to Sonic Pi 
has a good chance to follow what you’ re doing and 
relate the code that they can read to the sounds they 
are hearing. 
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FIVE LIVE-CODING TECHNIQUES 


Master live loops 
When working with more rhythmic music, it can 
often be hard to manually trigger everything and 
keep good time. Instead, it is often better to use a 
live_loop. This provides repetition for your code 
whilst also giving the ability to edit the code for the 
next time round the loop. They also will run at the 
same time as other live_loops, which means you 
can layer them together both with each other and 
manual code triggers. Take a look at section 9.2 of the 
built-in tutorial for more information about working 
with live loops. 

When performing, remember to make use of 
live_loop’s sync: opt to allow you to recover from 
accidental runtime mistakes which stop the live loop 
running due to an error. If you already have the sync: 
opt pointing to another valid live_loop, then you 
can quickly fix the error and rerun the code to restart 
things without missing a beat. 


Use the master mixer 

One of Sonic Pi’s best kept secrets is that it has 

a master mixer through which all sound flows. 

This mixer has both a low-pass filter and a high- 
pass filter built-in, so you can easily perform 

global modifications to the sound. The master 
mixer’s functionality can be accessed via the fn 
set_mixer_control!. For example, whilst some code 
is running and making sound, enter this into a spare 
buffer and hit Run: 


set_mixer_control! lpf: 50 


After you run this code, all existing and new 
sounds will have a low-pass filter applied to 
them and will therefore sound more muffled. Note 
that this means that the new mixer values stick 
until they are changed again. However, if you want, 
you can always reset the mixer back to its default 
state with reset_mixer!. Some of the currently 
supported opts are pre_amp:, lpf:, hpf:, and 
amp:. For the full list, see the built-in docs for 
set_mixer_control!. 
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Above Sam Aaron 
live coding at 
Moogfest, USA 


Use the mixer’s *_slide opts to slide one or many 
opts values over time. For example, to slowly slide the 
mixer’s low pass filter down from the current value to 
30, use the following: 


set_mixer_control! lpf_slide: 16, lpf: 30 
You can then slide quickly back to a high value with: 
set_mixer_control! lpf_slide: 1, lpf: 130 


When performing, it’s often useful to keep a buffer 
free for working with the mixer like this. 


Practice makes perfect 
The most important technique for live-coding 
is practice. The most common attribute across 
professional musicians of all kinds is that they 
practise playing with their instruments — often for 
many hours a day. Practice is just as important for a 
live coder as a guitarist. Practice allows your fingers to 
memorise certain patterns and common edits so you 
can type and work with them more fluently. Practice 
also gives you opportunities to explore new sounds 
and code constructs. 
When performing, you’ ll find the more practice you 
have done, the easier it will be for you to relax into the 
gig. Practice will also give you a wealth of experience 
to draw from. This can help you understand which 
kinds of modifications will be interesting and also 
work well with the current sounds. 


Bringing it all together 

This month, instead of giving you a final example 

that combines all the things discussed, let’s part by 
setting down a challenge. See if you can spend a week 
practising one of these ideas every day. For example, 
one day practise manual triggers, the next do some 
basic live_loop work, and the following day play 
around with the master mixer. Then repeat. Don’t 
worry if things feel slow and clunky at first — just keep 
practising and before you know it you’ ll be live-coding 
for a real audience. 
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Tutorial 


WESLEY ARCHER 


Self-taught Raspberry Pi enthusiast, 
founder of Raspberry Coulis, and 
guide writer for Pi Supply and Cyntech. 
raspberrycoulis.co.uk 
@RaspberryCoulis 


Our 7-inch screen mounted on the We've added the RaspCade logo 
RaspCade cabinet panel - it looks to our designs, but you can add 
fantastic when playing a game! your own if you prefer 


> 7-inch LCD 
screen (Search 
‘070-FPCA-R1" 


on eBay) 

> HDMI LCD driver 
board (Search 
‘PCB800168" 
on eBay) 


> Male-to-male 
HDMI coupler or 


mernvperm In this third part of the build, we’ll be showing you how 
alc § to assemble your display as part of your RaspCade homebuild! 


> 8x standoffs 


fany size) ow that you have your controls sorted, it’s 
(modmypi.com) : : . 
now time to get our display up and running The screen 
as without this, the RaspCade is nothing The screen we’re using was part of anow 
but a box with fancy controls! You could hook your discontinued case for the Raspberry Pi called the 
Raspberry Pi up to a TV, but where’s the fun in that? Qubit. It?s a 7-inch IPS screen with a maximum 
You can use pretty much any display in your RaspCade, resolution of 1024x600, and looks fantastic when up 
but in our build we used a 7-inch screen and the and running. If you’d like to use the same display, 
RaspCade cabinet is designed with this in mind. then look on eBay for a 070-FPCA-R1 screen and 
The trickiest part in this guide is mounting the screen, you should find plenty. However, you can use any 
but as you will see, this doesn’t need to be elegant. 7-inch display, as our cabinet has been designed to 
Let’s go! accommodate screens of this size. Just remember 
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Our screen came from the Qubit 
case for the Pi. The Qubit has 
since been discontinued 


hoon f= 


that you’1l need an HDMI LCD driver board to make 
your screen work! 


The HDMI LCD driver board 

The driver board makes the screen work properly and 
allows you to connect it to your Pi. Our screen uses 
the PCB800168 HDMI LCD driver board, which can be 
found on eBay, although it did come with the Qubit 
case. The screen connects to the driver board using a 
50-pin flex cable (similar to the one on the Raspberry 
Pi Camera Module), and the driver board connects to 
your Pi using an HDMI lead. To save space in our build, 
we used an HDMI coupler adapter, but any HDMI lead 
will work. 


Mounting the driver board 

As we’re connecting the driver board to our Raspberry 
Pi using a HDMI coupler adapter, we need to make 
sure it’s as close to the Raspberry Pi as needed. We 
connected the HDMI to the Pi and the driver board, 
then used a pencil to mark eight holes on the bottom 
panel of our RaspCade, in line with the mounting 
holes on the driver board and the Pi. We then drilled 
eight holes in the panel, and used the standoffs to 
secure both the Pi and driver board in place. 


Mounting the screen 

Before you secure the screen in place, it’s a good idea 
to check that it lines up nicely first. We drew around 
the screen on the back of the RaspCade panel with 

a pencil when we were happy, so we could line up 
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the screen when taping it in place. We then applied 
insulation (or electrician’s) tape around the edges 
of the screen, to ensure that it was held securely 

in place. Once the cabinet is assembled, nobody 
will see this, so it doesn’t have to be perfect! This 
way, we could keep the design simple and cut out 
unnecessary parts. 


Powering the screen 

As the screen needs to be powered separately to the 
Pi, the Qubit included a barrel jack connector that also 
provided power to the Pi, via a micro USB connector: 
see the close-up of the Qubit to learn how this was 
done. As we used the barrel jack connector, our power 
supply also uses this rather than micro USB, but 

it’s relatively simple to convert an existing Pi power 
supply to barrel jack instead of micro USB if you 
wanted to. Just be sure to use a decent power supply to 
ensure you have enough power: we recommend using 
at least 2.5A. 


Connect everything together 

Once you’re happy that your screen is mounted in 
the right place and that your driver board and Pi are 
too, it’s now time to connect everything together. 
Connect the 50-pin flex cable from your screen to the 
driver board (the same way you would for the Camera 
Module), and then connect your HDMI adapter/lead 
from your driver board to your Pi. You’ ll then need 

to connect the power leads (one to the driver board 
and the other to the Pi), and then connect your power 
supply. We’re almost ready to power up! 


This 
is our HDMI LCD 
driver board. You'll 
need a driver 
board to get your 
screen working 


properly 


We used 
this HDMI coupler 
adapter to save 
space in our build, 
but any HDMI lead 
will work 


BE CAREFUL 
WITH THE 


SCREEN! 


GOOGLE 
IS YOUR 


FRIEND 
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Apple PiFc HEP 


SCRATCH 
FOOTBALL 


This tutorial will teach you how to impress your 
footy friends with a game you can make in Scratch 


Football player 
magpi.cc/ 
2b55HYF 


Football 
magpi.cc/ 
2b560Ts 


Football pitch 
magpi.cc/ 
2b55s94 


TEMPLATES 
OR NOT? 


You can create 
your own ball, 
players, and/ 
or pitch if you 
wish, but the 
code definitely 
works with 

the assets 
provided. 


hether you like playing FIFA or coding games, 

this is the tutorial for you. In it, we will be 

making a basic football game using colour 
coding with Scratch. Scratch is a child-friendly 
programming environment which is developed by 
MIT. You can create games, music or even apps in the 
platform, and it’s well used in ICT lessons in schools. For 
this tutorial you will need to follow some easy steps to 
create a simple but effective game. 
Download the assets from the list on the left and 
import the football pitch. You will need to add three 
football player sprites, you can choose or create any 
football costume you want, but make sure they have a 
yellow outline. 
Every single football game needs a football; you can 
make your own or use the downloadable asset. Now 
we've finished designing and downloading all of our 
costumes and backgrounds, we can focus on making the 
code behind it. The football will be our player, and will 
be controlled using the arrow keys on your keyboard. 
To start, you need to get awhen up arrow key pressed 
block, then attach a point in direction @ block 
followed by amove 10 steps. It should look like this: 


when up arrow . key pressed 


point in direction Cov) 


move 10) steps 
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The players move and are your opponents. 
If you bump into them, they score a point 


This is your character; you move it, try to dodge 

the other players, and score a goal 

You need to do the same for the down arrow, but with 
a direction of 180. After that, do it again for the left 
arrow (-90), and finally the right arrow (90) like so: 


when up arro key pressed 
point in direction G9 


move @ steps 


when right arro 


point in direction €f9 


when leftarrow key pressed key pressed 


point in direction 


move @ steps 


point in direction @EEW 
move @D steps 


Next we need to create the following four variables: 
Coins, Raspberry Pi FC (You), Apple Pi FC, and 
Time. They should all come up ina list; you need to 
untick the Coins variable so that the players don’t 
see it. You will now need to add the following script: 


when clicked 

switch costume to football 

show variable Time 

show variable Apple Pi FC 

show variable Raspberry Pi FC (You) 


hide variable Coins 


broadcast Start 


to 0 | 


set Raspberry Pi FC (You) 
to 
to 


set Apple Pi FC 


set Time 


This shows that when the green flag is clicked, it 
will switch the ball costume to ‘football’. It will also 
show the variables Time, Apple Pi FC, and Raspberry 
Pi FC (You); however, it will hide the variable Coins. 
We then broadcast ‘Start’, which broadcasts a 
message all around the program and can be used 
to trigger other parts of the code. After this, we set 
the variables Raspberry Pi FC (You) and Apple Pi 
FC to o. The amount of time for this game is set to 
120 seconds, shown in the last block of code above, 
but you can change that as you wish. You can add 
sound effects to the game by having a beep play for 
every second left, which we can set to slowly become 
deeper. Do this by adding the following to the bottom 
of the code: 
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SCRATCH FOOTBALL 


This script tells the game that if you go out of 
bounds or hit a player, it should give the opposite >SCRATCH 
team a point. You will then go back to the centre of 
the pitch at the aforementioned coordinates. Earlier DOWNLOAD: 
on, we mentioned a yellow outline: the code uses hae alseiscs le 
Sean coins colour coding to tell Scratch that yellow triggers 
broadcast Start scoring for the opposite team. Now we need to go to 
Sat Raspberry PIFC (vou) . to fi our first player and complete their code (below left). 


set Apple PiFC to J 


set Time to RED) 


repeat Time 


Rut @D vance 

, 

play note ‘GJP- Time for CEP beats 
R 


change Time by r-1) 


clicked 
switch costume to football 


show variable Time 


show variable Apple Pi FC 


show variable Raspberry Pi FC (You) 


when clicked 


switch costume to footballer switch costume to footballer 


go to x: GE y: go to x: G4) y: @& 


if on edge, bounce if on edge, bounce 
broadcast Time Up 


forever forever 


if on edge, bounce if on edge, bounce 
. s % h b 
The next script should look like this one: repeat @ repeat @ 


This makes sure that when the football is on the ion adaetl bounce iffonfedganibounce 


> > 
point in direction for) point in direction risoy) 
> b 
wait 1) secs wait C1) secs 
’ , 
move 10) steps move rio) steps 
> > 
move Tio) steps move ia) steps 
z; 


when clicked 


switch costume to football 


show variable Time 


show variable Apple Pi FC I 
show variable Raspberry Pi FC (You) repeat C7) 
if on edge, bounce “if on edge, bounce 
> > 
Feoint in direction 13807) point in direction ov) 
bh 
wait ro secs wait 1) secs 
, ' 
4 move io) steps move P10) steps 
> 


move 10) steps move 10) steps 


hide variable C< 
set |Raspberry Pi 
set Apple Pi FC 
forever 


wait until touching color 2 
' 
change Raspberry Pi FC (You) by to 


> 
go to x: Dy: 


goal colour (in this case grey), it will add a point for 
your player (in this case Raspberry Pi FC). It will then 
reset the football to the middle of the pitch, which is 


It may not be FIFA, butit's a 
at the coordinates ‘x = -90 and y = -6’. You’ ll need to football Qalne youve made 
create another script for the football; this will be the 

last one for the football, and it will also use the colour ql] by yourself 


coding technique described above. 


This code will make the football player go up and 
down. We use angles for this by setting coordinates 


vs see and then a direction from 0-180. 

AED COORD ED MEAL Now we move on to our other football player: 

anoevarabis) Time their script is very similar to the first player’s, with 

show variable) Apple Pi FC opposite directions specified for a slightly different 

show variable Raspberry Pi FC (You) obstacle. The code is shown above right. We’1ll keep 

hidaivartable) Coins the final player stationary, so he doesn’t need any Two 

set Raspberry PIiFC (You) to code written for him. PLAYERS? 

set ApplePiFC to fy And you’re done! It may not be FIFA, but it’s 

forever a football game you’ve made all by yourself. To Can you figure 
f ; out a way to 

Wait until) touching color Mil 2 improve the game, you could add a start menu or ERG aKwo: 

a Se add code for the Coins variable, so that you Biever mode, 
eS to x: Dy: @ can collect coins and use them to upgrade your Aes Bune 


football. It’s all up to you, and we hope you have 
atts bee =f st Ee AS | fun tinkering! 


player? 
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PHIL KING 


When not sub-editing The MagPi and 
writing articles, Phil loves to work on 

Pi projects, and to help his six-year-old 
son learn Scratch coding. 

@philking68 


This space rock floats 
around and bounces off 
the edges of the screen 


The star is given a twinkling 
effect by scaling its size up 
and down repeatedly 


At the start of the animation, 
the spaceship takes off 
vertically before being told 
to point towards the Earth 


Program your own animation of a spaceship heading for Earth, using 
a scaling effect to make the ship smaller as it moves into the distance 


n this tutorial, you’ll be creating an animation List (bottom-right), select the Backgrounds tab (top- 
suet sequence which, perhaps unexpectedly, middle), then click Import and navigate to ‘stars’ 
involves a rotating space monkey! This in the Nature folder. Since none of the sprites used 
> Art assets : é 2 ; : : : 
mogplee/, project will show you how to move, rotate, and scale n this project are in the Scratch 1.4 library, you can 
scratch_art sprites. This is something which will also come in very download them (magpi.cc/scratch_art). First, let’s 
eat nietiorseaes handy for other projects and games. So, start anew import the Earth and Spaceship sprites: for each, click 
adventure Scratch project and get ready to do some animating. the star/folder above the Sprite List, then navigate to 
If you need any help navigating the Scratch menus, the folder where you’ve stored your sprites. 
refer to our Scratch Essentials book listed below. 


Move the spaceship 


Prepare your artwork Click the Spaceship sprite in the Sprite List to select 
After deleting the cat (right-click and Delete), it’s it, then click the Scripts tab. Listing 1 shows the script 
time to import a new stage background and sprites. you need to add to this sprite to make it move. First, 
Let’s begin by creating our space scene, changing we point it upwards (point in direction @) and tell 
the stage to a field of stars: click Stage in the Sprite ittogo to x: -15@ y: -150, near the bottom-left 


corner. After waiting one second, we use the handy 
point towards Motion block to point it at our Earth 
sprite. We then use a repeat loop to keep moving it 
towards Earth, two steps at a time. 


This tutorial 


SD 
was adapted cf bes o oO = 
from a Code NT 8) 7) ‘ 
Club project C Scale the ship 
(codeclub To simulate the spaceship moving further away from 


projects.org) 
and you can 
find more in 
Learn to Code 
with Scratch: L oK | Cancel 
magpi.cc/ = 
Scratch-book In the Paint Editor, draw an ellipse around the monkey's by block and drop it just below your move 2 steps 
head to give him a space helmet block, within the repeat loop. Change the 10 of the 


us, we need to gradually reduce its size as it moves 
towards Earth. This is easily achieved by adding a 
single extra block to its existing script. Click the Looks 
button in the top-left pane, drag a change size 
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LOSTINSPACE YJutorial 


Above: The spaceship points towards Earth, and is gradually 
moved and shrunk within a repeat loop 


change size block to -0.5. The code should look like 
Listing 2. Now, try clicking the green flag to see your 
space rocket hurtle towards Earth, getting smaller all 
the time. 


>STEP-04 

Add a space monkey 

Now let’s add a few extra features to our space scene. 
For a bit of fun, we’ll add a floating monkey who’s lost in 
space. Click on the star/folder icon again and navigate to 
your Lost In Space sprites folder, then select Monkey. As 
with any sprite, you can adjust its size using the Grow/ 
Shrink sprite icons above the stage. Now let’s give our 
monkey a space helmet! Select it in the Sprite List, then 
click the Costumes tab and the Edit button. In the Paint 
Editor, select the Ellipse tool, the outline option (on the 
right) below the tools, then a yellow colour from the 
palette. Now draw a yellow ellipse around the monkey’s 
head for a helmet. To make things more interesting, 
we’ ll make our monkey spin around by adding the 
simple looping script in Listing 3. 


>STEP-05 

Bounce and shine 

Finally, we’ ll add a shining star and bouncing rock. 
Import them both from your Lost In Space sprites 
folder, then position and scale them on the stage 
to your liking. For the star, add the code from 
Listing 4 (two repeat loops inside a forever one), 
to repeatedly scale it up and down in size. Add the 
Listing 5 code to the rock to get it moving, including 
a special block to make it bounce off whenever it 
reaches the edge of the stage. 


>STEP-06 

Taking it further 

Your animation should look pretty cool by now. Try 
playing around with various parameters to see how 

they affect the speed, movement, and scaling of the 
objects. You could also add your own touches, such 

as using a change color effect block to give the 

spaceship a fancy disco-light effect as it moves! 
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when clicked when clicked 


set size to 61) % set size to §Tp % 
clear graphic effects clear graphic effects 


point in direction Cha point in direction (}g 


wait 1} secs 
point towards Earth | 


when clicked 


forever 


turn G §3 degrees 


when clicked 


forever 


when clicked 


point towards Earth | 


move 2 steps 


if on edge, bounce 
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> Camera Module 


> Arduino Uno 
magpi.cc/ 
2bkQ93a 


> 16x2 character 
?C LCD display 
magpi.cc/ 
2bkQcMh 


> Nokia 5110 
screen (optional) 
magpi.cc/ 
2bkQvGZ 


> Adafruit mini 
pan-tilt kit - 
assembled with 
micro servos 
magpi.cc/ 
2bkPsa7 


> Membrane 4x4 
button pad 
magpi.cc/ 
2bkQDpX 


> 5V mini DC 
relay, LED, 
270Q resistor, 
male-to-male 
and male-to- 
female jumper 
cables, various 
breadboards 


The pan-and-tilt 
mechanism is 
mounted on top 
of the rig: make 
sure your cables 
are long enough! 
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SPENCER ORGAN 


Chemistry and physics teacher, 
Raspberry Pi enthusiast and Certified 
RPi Educator from the West Midlands 
with a passion for running workshops 
and building fun, educational, and 
practical things with the Pi! 
magpi.cc/2bkQ53q / @ mruktechreviews 


PROGRAMMABLE 
CAMERA RIG 


Take stunning motion-controlled time-lapse frames with your 
Raspberry Pi and Arduino wherever you go 


he small form factor, lower power use and the 

high-quality camera on the Raspberry Pi makes 

it an ideal platform for capturing time-lapse 
frames. In this project, we’ll use an Arduino Uno to 
control the motion of the Raspberry Pi Camera Module 
and to trigger the photos being taken. 


Connect pan-tilt kit 

We start the project by connecting the Adafruit 
pan-tilt kit to the Arduino. Use a breadboard to 
connect a common 5V and ground line from the 
Arduino. Connect the red power cables on each of the 
servos to the common 5V line, and the brown wire to 
the common ground. Use jumper cables to connect 
the orange signal wire of the pan servo to digital pin 9 
on the Arduino, and the orange signal wire of the tilt 
servo to digital pin 8. 
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Connect the I’C display 

Once we have connected the servos, we can add the 
PC LCD display to the Arduino. For this, we’ll need 
four jumper cables. Connect the GND pin to the 
lower ground connector, then connect the VCC pin to 
the common 5V line we were using just now for the 
servo motors. Connect the SDA pin to the analogue 
A4 connector, and the SCL pin to the analogue A5 
connector. We’ll need to download the libraries for the 
PC LED display for the Arduino. The latest libraries 
can be downloaded from here: magpi.cc/2bkO5br. 


Connect the keypad 

Connecting the keypad can be one of the 

trickiest parts of the build. There’s very good 
documentation for setting up and using a keypad 
here: magpi.cc/2baan3b. We’1] also need to download 
and install the keypad libraries from this page. We 
have connected the rows to digital pins 5, 4, 3, and 2, 
and the column pins to 13, 12, 11, and 10. If you find 
incorrect characters being displayed when you press 
the keys, you’ll need to try reversing the order of the 
row and column pins; with a bit of trial and error, this 
should be easy to fix. 


Mount the Pi camera 

Mount the Camera Module onto the pan-and-tilt 
mechanism. We have found that a longer camera 
connector cable works better and prevents the camera 
getting stuck. Connect the other end of the camera 
connector to the Raspberry Pi, with the printed side of 
the ribbon cable pointing towards the USB ports. 
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TIME-LAPSE CAMERA 


We use a 5V DC relay 
to synchronise the 
Raspberry Pi photo 


> 
capture by the Arduino PYTHON 


DOWNLOAD: 
magpi.cc/2baagcq 


4S ORB) 
080G 


>STEP-05 

Connect the Nokia 5510 screen (optional) 

This optional LCD display allows you to see how 
many pictures have been taken. There are two 
versions of this display, so we advise you to check 
the pin layout and adjust as necessary. Excellent 
documentation and links to the Python libraries can 
be found in this PDF guide: magpi.cc/2bkPU8g. 


LCC VCC is connected to 3.3V 

LCD GND is connected to a ground pin 
LCD D/C is connected to GPIO 23 

LCD RST is connected to GPIO 24 

LCD CS is connected to SPI CEo 

LCD CLK is connected to SPI SCLK 
LCD DIN is connected to SPI MOSI 


There is an optional Backlight pin, which can be 
powered off the 5V from the Raspberry Pi or from 
the Arduino. If powering it from the Arduino, you’ 
also need to connect the LCD GND to a ground pin 
on the Arduino. 


>STEP-06 

Adding a relay and LED 

We now come to the stage were we connect the 
Raspberry Pi and the Arduino together. The Arduino 
controls the movement of the servo motors, moving the 
camera as well as telling the Raspberry Pi when to take a 
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We use a keypad on the 
Arduino to enter all the 
settings for the camera motion 


50Gb 


in 


a i 


photo. To ensure that the camera isn’t moving, we have 
included a three-second countdown and delay in the 
Arduino code before each photo is taken. The Raspberry 
Pi simply waits for a switch to be closed between GPIO 15 
and ground. This switch is provided by a small 5V relay 
powered by digital pin 7 on the Arduino. 

Depending on the relay you have purchased, you’ ll 
first need to connect the coil to digital pin 7 and ground 
on the Arduino. The switch part of the relay can then be 
connected to ground and GPIO 15 on the Raspberry Pi. 
You should hear a satisfying click every time a photo is 
taken, as the relay closes and then opens again. 

One final step is to add an LED to give a confirmation 
that a photo has been taken successfully. Connect the 
longer LED leg (positive) to a 270Q resistor and then to 
GPIO 16, and the short leg to ground. 


Above Create 
beautiful time- 
lapse videos: 

see an example at: 
magpi.cc/ 
2zbagMOQ 
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YOUR QUESTIONS ANSWERED 
NEED A 
PROBLEM 


FREQUENTLY peel 
ASKED QUESTIONS Wizezes 


Email magpi@raspberrypi.org or 


to feature in a future issue. 


Your technical hardware and software problems solved... ta 


Binary explanation 


Binary files are installable pieces of software that 
work a lot like Windows or OS X software; in many 
cases they’re exactly the same as the file you’d be 


installing from the repository, only you need to 


download and install this one manually. 
Getting a binary 


Not all binary files will work on Raspbian; they’re 
usually built for specific versions of Linux. Generally, 

a compatible binary will either tell you it’s for Raspbian, 
or at the very least be a .deb file for ARM systems. 


From the repos Install the binary 
Raspbian, based on Debian, has access toahuge amount Download the binary to the Raspberry Pi and open up 
of software that can be quickly downloaded and installed the terminal. From there, use cd to move to where 


to your Raspberry Pi. It’s a bit like a mobile phone app the binary was saved and then use: sudo dpkg -i 
store compared to an install wizard. [binary name]. Follow this with sudo apt-get 
install -f. 


Find the software 


You need to install software via the terminal, but 
you need to know the package name to install it. For 
example, Google Chrome is chromium~-browser. Use 


Google to find out the package name of the software Get the source code 


you want to use. If the software is not available in the repos, or isn’t 
the right version, you can always download the source 

Install via the terminal code and compile the software yourself manually. Put 

Once you know what you want to install, you need to the source code in its own folder in the home folder 


open up the terminal or go to the command lineanduse and make sure it’s unzipped. 

acommand like the following: sudo apt-get install 

[package]. Replace [package] with the name of the Follow the instructions 

software and follow the on-screen instructions to install. There should be a README file telling you how to 
compile that particular bit of software. Depending on 


Right Install PE@E=*o CRA 5 Cond . Pe 
incase . how big it is and what Pi you use, compiling may take 
to improve awhile. Follow the instructions closely or it may not 
the Raspbian : 
experience install properly. 


Fixing dependencies 

During compiling, it may stop due to the program 
needing extra software to build. It will tell you what 
software is missing, which you will then need to install 
via the repos in the terminal, like we did in the first 
section. Once they’re installed, start the latest step again. 
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What operating system does the Raspberry Pi use? 
There are several official distributions (distros) available 
on our downloads page. New users will probably find the 
NOOBS installer the easiest to work with, as it walks you 
through the download and installation of a specific distro. 
The recommended distro is Raspbian, which is specifically 
designed for the Raspberry Pi and which our engineers 
are constantly optimising. It is, however, a straightforward 
process to replace the root partition on the SD card with 
another ARM Linux distro, so we encourage you to try out 
several distros to see which one you like the most. The OS 
is stored on the SD card. 


Does it have an official programming language? 

The Raspberry Pi Foundation recommends Python as a 
language for learners. We also recommend Scratch for 
younger kids. Any language which will compile for ARMv6 

(Pi 1) or ARMv7 (Pi 2/73/Zero) can be used with the Pi, though, 
so you're not limited to using Python. C, C++, Java, Scratch, 
and Ruby all come installed by default on the Raspberry Pi. 


Will it run Wine, or Windows, or other x86 software? 

In general, this is not possible with most versions of the 
Raspberry Pi. Some people have put Windows 3.1 on 

the Raspberry Pi inside an x86 CPU emulator in order to 
use specific applications, but trying to use a version of 
Windows even as recent as Windows 98 can take hours to 


This is an entirely new version 
of the operating system 


boot into, and may take several more hours to update your 
cursor every time you try to move it. We don't recommend 
it! As of summer 2015, a version of Windows 10 is available 
for use on the Raspberry Pi 2. This is an entirely new 
version of the operating system designed exclusively 

for embedded use, dubbed the Windows 10 Internet of 
Things (loT) Core. It doesn't include the user interface 
(‘shell’) or the desktop operating system. 


Having trouble with The MagPi on the App Store or Google Play? 


Here are your most common questions answered: 


How do! find The MagPi on Google Play or the App Store? 
Allyou have to do is go to the search bar and type ‘The MagPi’ 
or ‘Raspberry Pi’ to find us. 


I've subscribed to the digital edition and | can't sign 
in to restore my purchases. Please help! 
Since your The MagPi purchases are linked to your Google or 


Apple accounts, there's no need to sign in at all. If you'd like to 


re-download your purchases on your current device, or make your 
purchases available on other devices, all you need to do is press 
‘Subscribe’ on the home screen, then ‘Restore Purchases’ on the 


next screen. 
GET ITON 


> Google Play 


How can! search the digital magazine for keywords? 

Finding direct references is really easy with The MagPi app: all you 
have to do is tap the screen to get the app's GUI to show, and then 
press the small magnifying glass icon in the top-right corner of the 
screen. Just type in your search term to find the relevant results. 


4  =Available on the 


@ App Store 
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FREE 


Subscribe in print for six or 12 months to receive this stunning free gift 


Subscribe today & receive: 
A free Pi Zero v1.3 (the latest model) 
A free Camera Module connector 
A free USB & HDMI cable bundle 

Delivered with your first issue! 


Other benefits: 

Save up to 25% on the price 

Free delivery to your door 
Exclusive Pi offers & discounts 

Get every issue first (before stores) 


RASPBERRY PI MAGAZINE 


& 
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a a 
P aa ane: ol r 2 
Pp r i C i Nn Gg This subscription is: a For me | A gift for someone Mag#t49 


Ms 


Get six issues: se cea a eee 


AQUOSS  ssssscsscsccscssssnansnasecaases daseseatucasassovancsseasaceavevessedcacecasespaaeveneceeceaverssseaiedsécessesaeser 


£,30 (UK) Sessa sscBeceacthesasuageecg.cotsspep2ecenseassaaeeeeesssssstassepefvscesrsietitushtatesqsettasss aeeceeceasestaastee-snsoes 


£45 
MrL|] mrsl_] miss_| msl] 
S69 cad AS Re 


RAATOSS oiasii0s22tasssesssincessssusceseenses jacceceoansdeasssacdevessaasiusadeessb bags loveasdegecbeeieaand aeeceseeeedeare 


£50 (Rest of World) oe 


PAYMENT OPTIONS 


e : 
Fs Instruction to your bank or building a a 
e 


Please fill in the form and send to: 
The MagPi, Select Publisher Services Ltd, Service user number 


{ 5 5 (UK) PO Box 6337, Bournemouth BH1 9EH 


Name and full postal address of your bank or building society: 


Daytime PHOMe < i.siccs sei sedcegecisedesesd zgccases MODIG 5 2occeysacananes s2eesasecbsteseagddde cesbesaaed deetaaanoeby 


*If giving The MagPi as a gift, please complete both your own details (above) and the recipient’s (below). 


ee) 
WW 
ee) 
i 
I 
eS) 


To: The Manager Bank/building society isc. ciicsassccoccscsatescisoonssssoessasdanceedesevasneoacdectassaces 


£80 Fhe ants tasdissshattnmnmeatergieaenmisnenince 


S29 i ill ODDLY), Ee 


Narie(s) OF accOunthOlder(S): Jecciesscziesseevussseestacced ecvisehestis eases swe seeelaeaees i edeied ccdesduesseeeeee 


£90 (Rest of World) Branch sor code LILINIUO Account number IL] | | IL] 


Reference 


(Official use only) 


Instruction to your bank or building society 
Please pay Select Publisher Services Ltd Direct Debits from the account detailed in this instruction 
subject to the safeguards assured by the Direct Debit Guarantee. I understand that this instruction 


e 
e may remain with Select Publisher Services Ltd and, if so, details will be passed electronically to my 
e ree 18SueS: banking society 


SIGUA sescinsisscistanaannersitaminenteniasbiastctiadniennttieesess Date / / 


| 
£ Di Debit) 
12 e 9 9 (UK) ( Irect e it ) | Banks and building societies may not accept Direct Debit instructions for some types of account. 
| 
S3 7 e 5 O (US ) ( qu arte rly) SUBSCRIPTION PRICING WHEN PAYING BY CHEQUE OR CREDIT/DEBIT CARD 


6 ISSUES UK £30 Europe £45  __]Rest of World £50 


12 ISSUES UK £55 Europe £80  __|Rest of World £90 


How to subscribe: 


Tenclose a cheque .. (made payable to Select Publisher Services Ltd) 


MasterCard Maestro Switch 


| 


(if s. 


Card number | | IL] | L| | IL | 


Expiry date Valid from hown) 


Issue number (if shown) Security number 


(last 3 digits on the back of the card) 


SIQNAI OE  eiecnyecrnernmneneenn neat Date / / 


I would like my subscription to begin from issue .........cecceeeeeeeeeeeeeeeeeees (month + year) 


4 Available on the 
RETURN THIS FORM TO: 

MagPi Magazine Subscriptions, Select Publisher Services Ltd, PO Box 6337, 
Bournemouth BH1 9EH 


Ss App Store 


Please tick this box if you DO NOT want to receive any other information 
from Select Publisher Services Ltd. 


GET IT ON Please tick this box if you DO NOT want to receive any other information 


: G Pl from other companies. 
00g € ay Please tick this box if you DO NOT want to subscribe to The MagPi newsletter. 


raspberrypi.org/magpi September 2016 MagPi | 67 


The Saturn V rocket is one of the most 
powerful vehicles of all time, and 
necessary for us to get to the moon 


APULLU 


Emulate the Apollo mission 
computers on the Raspberry Pi 
and make your own small step 
to the moon 


he Apollo space programme is the stuff of 

legend. Six manned moon landings resulting 

in 12 people walking around on a completely 
different celestial body to the Earth. The only 12 
people in history to have done so — and they did it 
nearly 50 years ago. 

The legacy of these historic missions is felt and 
revered to this day, and it’s safe to say the world 
would be a different place if they hadn’t happened. 
Will we ever return? Hopefully one day, and it might 
be our stepping stone to the rest of the solar system 
and eventually distant stars. 

For now, though, let’s honour the Apollo legacy by 
investigating the computers on board these incredible 
spacecraft, and how we can make our own Apollo 
computer on a Raspberry Pi. 


Buzz Aldrin stands on the moon in 
one of the most famous photos of 
all time from a legendary mission 
4 
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APOLLO P! | Feature 


The Apollo code, printed out and stacked, next 
to Margaret Hamilton who was the director of 
software programming for the Apollo missions 


GET THE SOURCE s 
CODE ON GITHUB! 7 gay 
magpi.cc/2abpPcb 


MOONPI 


From space to your Raspberry Pi 


The code for the moon landings is an amazing piece 


of history, but what does that have to do with the 
The computers on the Apollo spacecraft Raspberry Pi? A couple of years ago, the AGC code 


needed programming as well was ported to various versions of the operating 
system Linux to create a virtual AGC that people 


ou’ve probably heard someone say before how could use and learn from. It’s not a simulator in any 
y modern pocket calculators are more powerful sense of the word, but it can give you an idea of how 
than the Apollo spacecraft; they’re mostly working the computers in space might have gone. 
correct, although it’s tricky to properly compare. The Raspbian, the main Raspberry Pi operating 
Apollo Guidance Computer (AGC) was created for the system, is a version of the OS called Debian that has 
Apollo program, which featured a 1.024MHz clock been tweaked to work on the Pi. Debian itself is a 
speed, 16-bit word length, and. 2,048 words of RAM. popular distribution of Linux and the virtual AGC 
Not bits or bytes, words. worked on normal Debian, so getting it working 
As ‘primitive’ as it may seem 50 years later, it was on Raspberry Pi is quite simple! Over the next few 
powerful enough for the task. Of course, the computer pages we’ll teach you how to get it working on the 
needed more than power and that’s where the code computer powering the Astro Pis currently up in 
comes in. Programmed during the 1960s, the project space, in homage to the Pi’s moon-landing ancestor. 


was fundamental in creating what we know of today as 
software engineering. 

The code is written in assembly, which is a much 
‘lower-level’ programming language to something 
like Python, but was much more common in the 
Sixties, when programming computers was a fairly 
new concept. 

It was a marvel for its time. Now, as with all of 
NASA’s work, it’s open to the public. While you 
may have been able to access it in some way fora 
few years now, the Apollo 11 version of the code is 
now up on GitHub. Modern-day code collaboration 
software being used to house and distribute the code 
that got humans to the moon ~ an incredible time 


The AGC computer and its control pad. 
7 Computers were very different in the Sixties, 
courtesy ofNASA for computer science. relying mostly on magnetic ribbon for storage 


Allimages 
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feature 


THIS VIRTUAL AGC WAS s ie 
CREATED BY RON BURKEY: 7 mam 
magpi.cc/2b20asx ah 


SET UP YOUR 


APULLU 


Make your Raspberry Pi ready to pilot a spacecraft straight to the moon 


These fixed information 
indicators light up as 
different operations 
where performed by 
the computer 


These fixed information 


indicators light up as 
different operations 
where performed by 
the computer 


Programs were run on 
this display, with the 
VERB and NOUN and 
PROG boxes showing 
what was being run by 
the astronaut 


The results from the 
programs were shown 
on the last three lines 
- luckily all the results 
were numbers so they 
could be easily read 


t’s actually quite simple to get the virtual 
| AGC running on Raspberry Pi - all we need 
is a few libraries and the specific code. 
Luckily, Dave Honess of the Raspberry Pi Foundation 
has already built the code so we can download it 
and run it on the Pi without having to build it from 
scratch ourselves. 


Train up your Raspberry Pi 
We’ll need the latest version of Raspbian. If you’ve 
not reinstalled Raspbian in a while it may be best 
just to do a fresh install of Raspbian jesse to your 
SD card. You can find the latest image of Raspbian 
here: magpi.cc/IMYYTMo 

If you’re installing fresh or not you’ll have to make 
sure your Raspberry Pi is up-to-date. You can do this 
by opening the terminal and using the following: 


sudo apt-get update 
sudo apt-get upgrade 


Launch prep 

For the code to work, we need some extra software 
on Raspbian. You can install this with the following 
command in the terminal: 


sudo apt-get install wx2.8-headers 
libwxgtk2.8-@ libsd1l1.2debian libncurses5 


Thw wx2.8-headers and libwxgtk packages allows 
us to use the graphical interface that’s been created 
for the virtual AGC, which we’ll discuss over the page. 
The libsdl and libncurses packages lets the AGC have 
better access to Raspbian so it can work properly. 


Ignition sequence 
Once everything is installed, it’s time to download the 
code. You can either open a browser on your Raspberry 
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feature 


The AGC was installed alongside all 
the traditional aviation instruments 
used in the Apollo spacecraft 


and go to magpi.cc/2b5QZ4B to get the zip file, or you 
can download it in the terminal with: 


wget https://d1.dropboxusercontent. 
com/u/14125489/RaspberryPi/agc.zip 


You’ll need to unzip the file once it’s downloaded 
(unzip agc.zip if you’re using the terminal). Move it to 
its own folder in the home directory to make sure it’s 
all nicely contained before unzipping if you wish. 


Blast-off! 

This part you need to do in the terminal within the 
desktop environment. If you’re in the command line, 
use startx and then open a terminal window. 

From there use cd to move to the 1VirtualAGC 
folder that you unzipped (e.g. cd IVirtualAGC). After 
thatm cd into the bin folder within and run the 
Virtual AGC with: 


./VirtualAGC 


The option interface will start up. Select Apollo 11 
Command Module, click on Full on the DSKY option in the 
right hand column, and finally hit Run to use the AGC. 


PRUGRAMMING 


Operating the AGC is quite different to how we use 
computers today. Calculations and queries were made 
using a verb and a noun code — two-digit numbers 
that told the computer what to do. The verb was the 
action that the astronaut wanted the computer to do, 
while the noun was the data that the action needed 

to be done on. For example, pressing VERB and then 
05 followed by NOUN and 09 and then hitting Enter 
will display (the action) the alarm codes (the data) if 
there’s any problems with the AGC. In short hand this 
is referred to as VO5NO9E. 


IMPUORIANT 
CODES 


verbs: 


05 


06 


25 


27 
37 


47 
48 


49 
50 
54 
55 
57 
59 
60 


63 


69 
71 


75 


76 


77 


82 


83 


97 


2h) 


Display Octal Components 1, 2, 
3 in R1, R2, R3. 

Display Decimal (Rl or R1, R2 or 
Ri, R2, R3) 

Load Component 1, 2, 3 into R1, 
R2, R3. 

Display Fixed Memory 

Change Programme 

(Major Mode) 

Initialise AGS (R47) 

Request DAP Data Load 
Routine (RO3) 

Request Crew Defined 
Maneuvre Routine (R62) 
Please Perform 

Mark X or Y reticle 

Increment AGC Time (Decimal) 
Permit Landing Radar Updates 
Command LR to Position 2 
Display Vehicle Attitude 

Rates (FDAI) 

Sample Radar Once 

per Second (Ro4) 

Cause Restart 

Universal Update, Block 
Address (P27) 

Enable U, V Jets Firing During 
DPS Burns 

Minimum Impulse Command 
Mode (DAP) 

Rate Command and Attitude 
Hold Mode (DAP) 

Request Orbit Parameter 
Display (R30) 

Request Rendezvous 
Parameter Display (R31) 
Perform Engine Fail 
Procedure (R40) 

Please Enable Engine Ignition 


nouns: 


11 
13 
16 
18 


24 


TIG of CSI 

TIG of CDH 

Time of Event 

Auto Maneuvre to FDAI Ball 
Angles 

Delta Time for AGC Clock 


41 


42 


43 


45 


54 


61 


65 


66 


68 


69 


76 


89 


92 


Time from Perigee 

Time of Ignition 

Time of Event 

Time from Event 

Time of AGC Clock 

Time of Ignition of TPI 

(a) Time from Ignition/Cutof 
(b) VG 

(c) Delta V (Accumulated) 
Target Azimuth and 
Target Elevation 

(a) Apogee Altitude 

(b) Perigee Altitude 

(c) Delta V (Required) 

(a) Latitude (+North) 

(b) Longitude (+East) 

(c) Altitude 

(a) Apogee Altitude 

(b) Perigee Altitude 

(c) TFF 

(a) Marks 

(b) TFl of Next/Last Burn 
(c) MGA 

(a) Rang 

(b) Range Rate 

(c) Theta 

(a) TGO in Braking Phase 
(b) TFI 

(c) Cross Range Distance 
Sampled AGC Time 

LR Slant Range and 

LR Position 

(a) Slant Range to Landing Site 
(b) TGO in Braking Phase 
(c) LR Altitude-computed 
altitude 

Landing Site Correction, 

Z, Y and X 

(a) Desired Horizontal Velocity 
(b) Desired Radial Velocity 
(c) Cross-Range Distance 
(a) Landmark Latitude (+N) 
(b)Longitude/2 (+E) 
(c)Altitude 

(a) Desired Thrust Percentage 
of DPS 

(b) Altitude Rate 

(c) Computed Altitude 
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APOLLO 11 MADE ITS 


HISTORIC MOON LANDING AT ® imam 
20:18:04 ON 20 JULY 1969! Sm 


MUUN 


Check the time since launch and set yourself up.an Apollo clock on your Raspberry Pi 


ne of the most basic functions of the AGC 
was for the computer to keep track of the 
time. It was also an important function, 
GIMBAL aiding with mission planning and also figuring out if 

—_ it’s too early in San Francisco to give someone a call. 
eine PROG The virtual AGC keeps track of time since launch, 
or in this case time since the AGC was turned on. 
We can check this time by keying in V16N36E. 
OPRERR TRACKER - From the list of codes, this means we’re asking for 
the time (V16) of the AGC clock (N36). You might 
see this split into LGC, which is the lunar guidance 
computer that would have been the computer in 
the Lunar Module, or CGC which is the Command 
Module’s computer. Both use the same AGC 
hardware and code. 

After typing in the code, you’ll get three lines of 
numerical readouts. The top display will be hours, 
the second display is the minutes, and the third 
display is in 100ths of a second. The display is updated 
by the second, so you don’t need to keep repeating the 
code to keep an eye on the time since launch. 


The Apollo missions were a huge undertaking and 
the brightest minds in the United States were called 
upon to help on any relevant area. This means when 


the computer was to be designed and programmed, 
NASA went to MIT. In 1962, the project began and 
paved the way not only for modern computers but 


also modern software. 


In the Sixties, the term software was not as 
widespread as it was today — it was only really 
known to those who made it or were very close to 


‘ : ‘ : the projects that required it. Coming off the back 
Pioneering software SHEE CLULe of older computers, the concept of software to the 
at the dawn of computing 


hardware engineers was foreign and distrusted as it 
wasn’t a physical thing they could see, even if it was 
Top: James Lovell (of Apollo 13) can be seen here a fundamental necessity. 

Hagel tonal Apollo B= net tobi The whole thing was written in assembly 

Left: Margaret Hamilton, then lead software designer language, as discussed earlier, but many new 
programming techniques were invented to make 


sure the whole thing would work. Software could 


UPLINK 


ACTY TEMP 


NO ATT 


KEY REL RESTART 


on Apollo, tried to give legitimacy to software 
engineering in a time when it was looked down upon 
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Agiant leap that has a legacy which 
can still be felt nearly 50 years later 
Image courtesy of NASA 


Challenge! 
How would you go about 
calculating the time 
since Apollo 11 landed? 
Is it possible with the 
five-digit display to count 
that many hours? How 
eh Ow OS many years can the AGC 

actually count up to? 


ULK 


The AGC is a programmable computer, so it stands hale 
to reason we can reprogram the clock to show the 5 
current time. N36 can be modified down to the 100th 
of a second and we can modify it using V25; this verb 
allows us to load a component (change the number) 

in the readout of the noun, in this case the clock. 

On the AGC, use V25N36E and the top line (R1) will 
clear and you can change it to be the current hour by 
pressing + on the virtual keyboard and then using the 
numpad to key in the time. If you make a mistake, you 
can press CLR to start again, but once you’re happy 
you can press ENTER and move onto the middle line 
(R2) and set the minutes the same way. Remember, 
for the seconds it’s in 100th of a second increments so 
5 seconds would 500, 10 would be 1,000, etc. 

Use V16N36E to display the current time from 
this edited state. This will update every second like 
it did before and allow you to use the AGC as a clock. 
With a smaller screen and some inventive setting 
customisation, you can make it your main clock 
somewhere in your house. If you want to find out the 
time since bootup, you can always use a different key 
combination of V25N65E, and then return to your 
clock with V16N36E. When you restart the AGC, you’ll 
need to reset the clock, though. 


The clock is 
set to your specific 
time. It's not a 24- 
hour clock, though, 
so you may need to 
reset it sometimes 


= * a 
= 
be run asynchronously, and a priority scheduler Computers were also used od 7 
on the ground, of course, with 
allowed tasks for the computer to be executed Palsdlon eantel and ainutatcle J = 
when they were needed. keeping track of the flights v4 = 
These innovations were key to the successful aaa ~ 


landing of Apollo 11 on the moon: due to faulty a 
power supplied to the Lunar Module’s rendezvous -— 


radar (for the return journey), the AGC was 
overloaded with interrupts and an abort was 
nearly made. Due to the scheduling system and 
asynchronous program running, the computer 
was able to cope with the extra load, resulting 
in Apollo 11 landing safely on the surface 

of the moon. 

The software was continually updated and 
worked on throughout the rest of the Apollo 
missions. To work around the limitations, many 
little tricks were employed and in some cases the 
readability of the code suffered — a great reminder 
to always document your code! 
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The crew of Apollo 13 required a special 
startup process for their Command 
Module computer during the final 
stages of their fateful return home 


| 


ar, Ye Ni 
COMPUTERS 
IN THe SIXTIES 


Revolutionising hardware 
to send men to the moon 


One of the biggest problems with sending men to 

the moon was that all the equipment needed to do 

it didn’t exist yet. There were no rockets powerful 
enough to get that far and computers were the size of 
a room. In order to fit a computer into the confines of 
avery tightly designed spacecraft, a new technology 
needed to be invented: the microchip. 

Fairchild Semiconductor, which still operates 

today, was experimenting with the idea in the 

Sixties. NASA was keen to get them off the 
* ground and make sure they were high 

324 quality and well researched, so they 
placed an order for a million of 
them, knowing they would only 
need a few hundred. 

It worked and the 
integrated circuits were able 
to reduce the size of the 
computer down by a sizeable 
amount, allowing it to be 
small and light enough to fit 
in the craft and not hamper 

the flight to the moon. 


These microchips used in the AGC 
were some of the first 


SPALE 


Perform the vital tests needed to start 
up your AGC and get to the moon 


onsider the situation — you’ve just launched 
C into space on a Saturn V rocket on your way to 

the moon. Your spacecraft has performed its 
docking operation between the Lunar Module and the 
Command Module and you’re well on your way. This is 
when you need to check to make sure your computer 
is working properly — you don’t want any problems 
when you’re 100,000 miles from the nearest layby. 
Check the status of your on-board computer by using 
Apollo 13 Lunar Module and then follow these steps: 


Lamp check ‘nen 
V35E Soar 

There aren’t any 

LEDs as this is way nat 

1969, so to start wells 


the test we need 
to turn all the 
indicator lamps 
on to make 

sure they’re all 
working. If one 
is burnt out and 
it will tell you 
something important, you need to know. 


Start the main 
program 

V37E, 

OOE 
Program Poo, 
affectionately 
named Pooh 
after the bear, is 
one of the main 
programs for the 
AGC. PROG in the 
top right should 
show 00; this 
means your software is initialising and ready to work. 
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Error counting 
V25E, 
NO1E, 
Q@1365E, 
GE, GE, OPR ERR 
OE 

Before we begin 

the tests, we 

need to set the 
count of total 
failed self-tests, 
total started 
self-tests, and 
successfully completed division tests to 0. We want to 
make sure we know exactly how many errors we get in 
this test alone. 


Monitor 
the test 
v15, 
NQ1E, 
Q@1365E ms 
We’ve reset the 
counts; now 
we get ready 
to monitor the 
tests. We have to 
set up the three 
lines of output to 
do this first. The 
first row (R1) shows the number of failed tests, R2 
displays how many test have actually been made, and 
R3 shows the number of completed division tests. 


Begin 
the tests 
V21N27E, 
10E 
The tests will 
start and go 
through the 
computer. These 
will continue 
on as long as 
you want them 
to and you can 
stop them with 
V21N27E followed by oE. Hopefully your computer 
will be fine and you’!l be on your way to the moon! 


APULLD 
CUMPUNENIS 
USED TODAY 


Integrated circuits 
These were a revolution at the 
time, heralding a new future 
for computers. These are 
still widely used in almost 
all electronics in varying 
ways. You can also use a 

few with the Raspberry 

Pi on a breadboard, such 

as an analogue-to-digital 
converter chip. 


Number pad 
The calculator-style 
interface on the AGC was 
the first of its kind to 
use a number pad. As 
well as the calculators 
it inspired, you can see 
a very similar evolution 
of it on the number pad 
found on the side of a full 
computer keyboard. 
Image courtesy of NASA 


Seven-segment display 
While it didn’t change the 
world like the integrated 
circuit did, the seven- 
segment display for 
showing numbers 
is still used today 

- in fact, patents 
for it go back to 
1908. So when 

you plug one into 
your breadboard, 
remember this is a 
technology that is a 
century old! 
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up endless 
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ZEROBORG 


Control four motors independently with this versatile Zero-size board 
from the robot experts at PiBorg 


aspberry Pi robotics 
specialists PiBorg have 
turned their attention 

to the Pi Zero and the possibilities 
of using it to make very small 
robots. The result is the ZeroBorg, 
a diminutive motor controller 
board that’s only marginally 
wider than the Zero itself. When 
mounted to the rear of the Pi 
Zero, the whole setup (including 
optional 9V battery) weighs a mere 
65g. It’s so lightweight and nifty 
that PiBorg are using it to control 


MOTOZERO 


Resembling an 
exposed engine, 


it can control , ; : 
four motors the YetiBorg racing robots in 
independently, their upcoming Formula Pi series: 
lees see this issue’s news section for 
lacks any 


more details. 

The inclusion of four H-bridges 
means that the ZeroBorg can 
control four standard DC motors 
independently. Add some special 
Mecanum wheels and you can get 
your robot to scuttle sideways like 
a crab! Even when using standard 


sensor inputs. 


£10 / $13 
magpi.cc/1XRfqGQ 
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wheels, the ZeroBorg offers extra 
control since the bidirectional 
PWM (pulse-width modulation) 
signal sent to each of the four 
wheels can be varied precisely. 
Each H-bridge can deliver 2A peak 
or1.5A RMS current, so it should 
work with most small motors. 
Alternatively, the board can be 
used to run two four-, five-, 

Or Six-wire stepper motors. 


Stacks of fun 

One curious aspect of the 

ZeroBorg is that it’s designed to be 
connected to a Pi Zero that has an 
unpopulated GPIO header. Instead, 
it’s supplied with a small female 
header to fit to the rear of the Zero, 
at the 3V3 end of the GPIO header; 
into this you slot the ZeroBorg’s six 
pins, two of which connect to SDA 
and SCL for ?C communication. 
Now, while it’s possible to do 

this without soldering the small 


header to the Pi Zero, and instead 
simply holding the two units 
together firmly using the supplied 
standoff screws, we were unable 
to get this method to provide a 
reliable enough connection. Once 
we’d soldered the header to the Pi 
Zero, however, everything worked 
absolutely fine, so we’d strongly 
advise doing this. Alternatively, 

if your Zero already has a full GPIO 
male header attached, you could 
always use two 3-pin female-to- 
female connectors to connect it; 
this method would also enable you 
to use the ZeroBorg with any other 
Raspberry Pi model. 

It’s important to note that the 
ZeroBorg comes in three main 
versions. While the basic KS1 
model comes pre-assembled, 
the KS2 adds a DC/DC regulator 
and battery clip (supplied loose 
or pre-soldered) so that the 
ZeroBorg, motors, and Pi Zero 
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can all be powered by a standard 
OV PP3 battery. Alternatively, an 
external power source such as a 
battery pack can be attached to 
two of the ZeroBorg’s terminals, 
enabling you to mount it flat. 
The KS2 model also includes an 
infrared sensor (more on that 
later) and a second six-pin male 
PC header for daisy-chaining 
with other add-on boards, 


Motoring on 

We tested a pre-soldered KS2 
ZeroBorg for this review, so all we 
needed to do was solder the female 
header to the Pi Zero, screw in the 
standoffs, insert the battery, and 
we were ready to roll. Well, almost. 
First, you need to ensure [?C is 
enabled on the Pi, then install the 
ZeroBorg software using a single 
terminal command. It’s then just 


ZeroBorg software includes a 
special Python library, along 


with numerous examples 


including the UltraBorg, PicoBorg 
Reverse, or another ZeroBorg. 
Indeed, the KS3 option comprises 
a stack of three ZeroBorgs, the 
middle of which features two 
female I?C headers to allow 
communication between the 
three boards. While overkill for 
your average robot, this version 
could prove particularly useful for 
animatronics projects or running 
multiple servos ina CNC machine, 
for instance. All ZeroBorg models 
also include two analogue inputs 
(plus power and ground) for 
attaching sensors. 
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a matter of wiring up your motors as 
usual; the terminals are all located 
on one edge of the ZeroBorg, which 
isn’t quite as intuitive as on the 
rival MotoZero, but they’ re nice 
and chunky so they should prove 
durable. In addition, the ZeroBorg 
features short circuit prevention to 
prevent any damage from incorrect 
connections, along with overheat 
protection, under-voltage lockout, 
and a fast-blow 5A fuse. 

The ZeroBorg software includes 
a special Python library, along 
with numerous examples to 
get you started. It’s all fairly 


ZEROBORG 


From £18 / $23 


straightforward: for example, the 
ZB.SetMotor1(1) command is 
used to supply maximum speed to 
motor 1. Use a lower number for less 
power, zero to stop it, and a negative 
value to reverse. The examples 
include joystick control, stepper 
motor sequence, analogue inputs, 
and control using an infrared TV 
remote; if yours isn’t supported by 
default, it’s easy to record and save 
the raw IR codes and add them to 
the main script. We were soon using 
a TV remote to control our swiftly 
assembled ‘Tubbybot’, made from 

a small plastic storage tub to which 
we strapped four micro metal-gear 
motors and wheels. While not the 
fastest off the blocks, Tubbybot was 
able to do some nifty spin-turns 

by powering one pair of wheels 
forwards while reversing the others. 


{ast word 


Above left 

The ZeroBorgs are 
designed so they 
can be stacked on 
top of one another 


Above 

Build full robots 
with the tiny 
ZeroBorg 


While its connection method is a little 
unorthodox, the ZeroBorg is a mini marvel for 
motor control. The ability to power both the 
motors and Pi Zero using a single 9V battery 


should prove particularly useful when designing 
small robots, while the daisy-chaining options 
offer extra flexibility for other possible uses. 
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ENVIRO PHAT 


This Zero-size add-on features four built-in sensors plus analogue inputs 


SENSE HAT 


As used in the 
Astro Pi devices 
aboard the 

ISS, the Sense 
HAT features 
multiple built-in 
sensors and 

an 8x8 LED 
matrix display. 


£29 / $38 
magpi.cc/1TGGUtS 


hile not an official 

Raspberry Pi standard, 

Pimoroni’s pHAT class 
of half-size add-on boards are 
great fun and match the Pi Zero’s 
form factor perfectly, although 
theyll work with any 40-pin Pi 
model. The latest addition to the 
line is the Enviro pHAT, which is 
all about taking environmental 
and motion measurements. Along 
with several built-in sensors, 
it features four analogue input 
channels to connect your own 
external sensors. In effect, the 
Enviro pHAT is Pimoroni’s Flotilla 
weather, colour, and motion 
modules rolled into one, with the 
addition of an analogue-to-digital 
ADC) converter. 

First things first: the Enviro 

PHAT comes in kit form, so 
you'll need to get your soldering 
iron out to attach the 2x20-pin 
female header and six male 
pins for the analogue inputs. 
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Alternatively, you could even 
solder the pHAT straight onto 
the GPIO pins of a Pi Zero, if you 
wanted to use them together as a 
permanent room-monitoring or 
motion-measuring device. 
Once the pHAT is assembled and 
mounted on the Pi’s GPIO header, 
installing the software requires 
just a single command in the 
terminal. Assuming your Pi already 
has ?C enabled, you’re then able 
to start coding to obtain readings 
from the sensors, using 
own Python hbrary. The latter 
is partitioned into five separate 
modules: light, weather, motion, 
analog (inputs), and leds. 


Modular sensors 

The light module offers two 
main methods for reading the 
built-in TCS3472 sensor, which 
monitors four different values: 
clear, red, green, and blue. As well 
as an ambient light level reading 


the pHAT’s 


using light. light(), you can 
obtain RGB colour values with 
light .rgb(), for a tuple which 
can easily be split into separate 
values. As you can see, the 
function naming structure used 
by the library couldn’t be simpler, 
so it’s all very easy to code. To aid 
accuracy of colour readings, the 
board has two small white LEDs 
located on either side of the light 
sensor, which can be switched 
on and off using the leds Python 
library module. Even so, the colour 
values produced are for a duller 
shade than the real item analysed, 
so may require some calibration. 
The library’s weather module 
enables you to obtain temperature 
and barometric pressure (in hPa) 
readings from the Enviro pHAt’s 
BMP280 sensor, but it doesn’t 
measure humidity. Since the sensor 
is mounted on the PCB rather than 
remotely, its temperature reading 
is greatly affected by the heat of 
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BUILT-IN SENSORS 


The highly sensitive TCS3472 colour sensor 
enables you to measure the ambient clear light 
level and RGB colour values, aided by twin LEDs 
to illuminate objects. 


A BMP280 sensor measures atmospheric 
pressure and temperature, although the latter is 
affected by the heat produced by the pHAT. 


The built-in LSM303D 3D accelerometer/ 
magnetometer can detect the board's orientation, 
motion, and compass heading. 


An ADS1015 ADC enables it to 
convert analogue readings from external sensors 


Above Everything is neatly labelled on 


the board so you know what does what 


the Raspberry Pi CPU beneath it. 
Therefore, you’ll need to calibrate 
it by comparing the real ambient 
temperature, using a standard 
thermometer, to discover the 
difference, for us it was around 
7°C, but it may vary depending 

on the setup. For a more accurate 
reading, you could always use a 
remotely placed temperature sensor 
connected to the pHAT’s analogue 
input section: more on that later. 


Detecting motion 

The Enviro pHAT includes 

an LSM303D accelerometer/ 
magnetometer for detecting the 
board’s motion through three 
axes (pitch, roll, and vertical) 
and its compass bearing. The 
atter can easily be calibrated 

to north, so long as you already 
know where that is; it’s done 

by setting a variable to its value 
and subtracting it from the 
reading (with modulo 360) to 

get the correct compass heading 
in degrees. Meanwhile, the 
motion.accelerometer() tuple 
can be split into three variables, 
one for each axis. You can also 
obtain the raw magnetometer 
data if you prefer. Since the 
combination of Enviro pHAT and Pi 
Zero has such a small form factor, 
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it’s ideal for measuring the motion 
of people carrying it or objects 
attached to it, although it’ll require 
a portable power source such 

as a phone charger. 

Last but not least, the Enviro 
PHAT features an ADS1015 ADC for 
reading external analogue sensors. 
Located on a short edge of the board 
are Six pins: 5V power output and 
ground, plus four input channels to 
take readings from sensors. Note 
that the input pins are designed to 
measure signals between 0 and 3.3V, 
so if your sensor’s output is 5V you’ll 
need to create a voltage divider, 
using three identical resistors on 
a breadboard, to lower it to 3.3V. 
While Pimoroni says that in its tests, 
running 5V into the ADC inputs 
didn’t cause any adverse effects, the 
readings won’ t be reliable unless 
you use a voltage divider. It’s not 
much of a hurdle, though, and 
the inclusion of an analogue input 
section for connecting extra sensors 
is amajor bonus. 

Overall, with its similar 
functionality, the Enviro pHAT is a 
cheaper, more portable alternative 
to a Sense HAT, although without 
the LED matrix and a few other 
features, but with the addition of 
analogue inputs for extra sensors. 
The Python library is very intuitive 


on four channels. 


and easy to use, aided by an online 
tutorial (magpi.cc/29maHZT) to get 
you started and a few helpful code 
examples in the GitHub repository 
(magpi.cc/29M8bdD). With its small 
form factor, we can see the Enviro 
pHAT being used with a Pi Zero to 
create IoT devices for monitoring 
room temperature, light levels (to 
possibly trigger electric lighting), 
and various other remote uses. By 
using a stacking header, it could 
also be combined with another 
Pimoroni pHAT, such as the Scroll 
pHAT with its LED matrix, to display 
its readings in situ. 


{ast word 


For portable projects requiring 
sensor data, the Enviro pHAT 
could prove particularly 
useful. You could just mount 

it on a Pi Zero and leave it 

ona shelf to monitor room 
conditions, for instance, 


logging its readings into a file 
or database. The inclusion of 
an ADC and analogue inputs 
for external sensors is a 
bonus for what is a fun, easy- 
to-use add-on with plenty 

of possibilities. 
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Can be 

mounted to 

Raspberry 

Pi Zero 

back-to-back 


UUGear 


THREE- 

PORT USB 
HUB WITH 
ETHERNET 


You'll need 

a micro USB 
adapter to 
plug it into the 
Pi Zero, but it 
has the bonus 
of an Ethernet 
port for wired 
connectivity. 


& 


a 


£10 / $13 
magpi.cc/2qFJkx9 
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ZERO4LU 


hile the Raspberry Pi 

Zero’s compact nature 

makes it ideal for many 
projects, the downside is that it 
only offers a single micro USB port 
for connecting peripherals. So, to 
use it with a keyboard and mouse, 
for instance, you’ ll need a USB 
adapter and a standard USB hub. 
Well, not any more... 

Designed by UUGear in the Czech 
Republic, the Zero4U is a four-port 
USB hub that’s mounted on the 
rear of the Pi Zero. Its four pogo 
pins connect to the tiny PP1 (+5V), 
PP6 (GND), PP22 (USB D+), and 
PP23 (USB D-) testing pads on the 
Pi Zero. This enables it to take its 
power from the latter, in which 
case it can output up to 2A current 
to all four USB ports. 

Since the pogo pins are only in 
surface contact with the pads, they 
need to be kept firmly in place by 
securing the Zero4U to the Pi Zero 


using the plastic standoff screws 
and spacers supplied. We were 
slightly concerned about the pins 
maintaining a reliable contact, but 
didn’t experience any problems. 
One detail to note is that since the 
testing pad positions are slightly 
different on the two Pi Zero models 
— the original v1.2 and new v1.3 
with camera connector — there are 
two versions of the Zero4U to suit, 
so you need to ensure you order the 
correct one. Either way, the Zero4U 
can also be used with any other 
Raspberry Pi model via its mini 
USB input, although the power 
output is reduced in this case 
unless you power it independently 
via its JST XH2.54 port. 

Once the Zero4U is piggybacking 
the Pi Zero and powered on, a blue 
LED lights up to show that it’s 
operating. In addition, each port 
has a white status LED that’s lit 
whenever a device is connected to 


Adding four USB ports to the Pi Zero, can it replace a USB hub? 


it, which is a nice touch. All four 
ports operate at standard USB 

2.0 speed (480Mbps). The only 
caveat is that if you insert a USB 
1.1 device, they’ ll all be slowed 
down to 12Mbps, since the hub has 
a single transaction translator, 
but it’s not a major problem. 


{ast word 


The Zero4U is an ingenious 
solution to the lack of 
standard USB ports on the 
Pi Zero. There's no soldering 
required and it’s relatively 
easy to attach to the rear of 


the Zero, which means the 
GPIO header is kept free and 
unobstructed. As a bonus, the 
device can also be used asa 
standard USB hub for other 
Raspberry Pi models. 
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RASPBERRY 
PI CAMERA 
MOUNT 


Acheaper 
option is to buy 
a mount for just 
the Camera 
Module, but this 
doesn't provide 
a combined 
package. 


4 


£3/S4 
thepihut.com 
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ZapoWiew 
SEE 


Maker 
says 
The 
ZeroView 
is a clever 
window/ 
glass mount 
for your Pi 
Zero and 
Camera 


Module 
The Pi Hut 


ZEROVIEW 


Stick your Pi Zero with Camera Module to a glass window 
with this suction cup mount 


ne of our favourite uses 

for the Pi Zero is recording 

time-lapse video with the 
new camera connector (found on 
the newer Pi Zero v1.3). 

So we were delighted to get hold 
of the ZeroView. This simple board 
provides a suction cup mount 
for the Pi Zero, so you can stick 
it to glass. 

It’s ridiculously easy to set up 
the Pi Zero to record pictures, 
videos, or capture time-lapse 
photography. A device that 
effectively mounts the Pi Zero 
and holds the Camera Module 
comes in useful in a range of 
projects, from home-built in-car 
dash cams to time-lapse fish 
tank recordings. 

The Pi Zero is mounted using 
plastic screws. Inside the pack you 
get a PCB (but just a plain board 
with no electronic components), 
two suction cups, and spacers, 


screws and nuts to mount 

both the Pi Zero and Camera 
Module. It took us about five 
minutes to screw it all together 
following the PDF instructions at 
thepihut.com/products/zeroview. 

The Camera Module is mounted 
and the cable tucked between the 
Pi Zero and ZeroView. The end 
result is a compact, self-contained 
camera device that can be stuck 
to any glass surface. Combine it 
with a battery pack, and set up 
a script to automatically start 
recording, and you get a neat 
camera package. 

We’ve had trouble with suction 
cups before, where devices have 
dropped. With this in mind, we 
stuck the ZeroView to a window to 
capture a time-lapse video, and 
started a stopwatch to see how 
long it lasted. After an hour, we 
decided that it was going to be 
there all day and stopped the test. 


“We’ve hunted down the best 
quality suction cups we could 
find,” says The Pi Hut, “using only 
the best ‘Adams’ cups made in 
the USA. We’re so impressed with 
the performance of these suction 
cups that we just couldn’t use any 
other brand.” 

Whether it’s the high-quality 
cups or the general lightness of 
the package, it’s hard to fault the 
ZeroView. It’s easy to set up, looks 
cool, and sticks around all day. 


{ast word 


Aneat product that transforms 
the Pi Zero and Camera 
Module into a portable, 
stickable camera package 


ideal for time-lapse and slow- 
motion photography projects. 
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Review 


PIPER 


Maker 
says 


Build your 


computer 
through 


Minecraft 
Piper 


PI-TOP 
Asimilar 
concept but a 
very different 
execution, 
the pi-top 
may be more 
suitable for 
older kids and 
young adults. 


£230 / $300 
pi-top.com 


82 | MagPi September 2016 


PIPER 


Build a computer and then keep building it as you 


play through a Minecraft adventure 


nce again, we’ve come 

face-to-face witha 

crowdfunded Raspberry 
Pi laptop. With the pi-top not 
even a year old, it’s interesting to 
see something that, on paper, is 
a competitor for the same space. 
A “build-it-yourself’ laptop that 
gamifies learning computing 
through a custom operating system, 
the Piper is very different from 
the pi-top when it comes down to 
it, however. 

First of all, construction of the 
laptop is very different. While 
the pi-top feels like you’re 
assembling the components for a 
real laptop, Piper feels like putting 
together a Meccano kit or wooden 
model. Laser-cut, engraved 
wooden sections slot into place, 
held together by the odd screw. 
There’s a big sprawling poster 
with the steps needed to put the 


box together, with the engravings 
giving you some visual clues on 
what goes where. The poster is a 
little unwieldy and you need lots 
of space for it, but construction is 
fairly simple, if not a little lengthy. 
We sat through at least a couple 

of episodes of Star Trek: Deep Space 
Nine getting it built, so it took 
about 90 minutes. 


Some assembly 
required 
The final build is chunky and 
sturdy. The computer parts include 
anice 7” LCD display in the top, 
a Raspberry Pi, a USB mouse, and 
a portable power bank to power 
the whole lot. This makes it quite 
mobile, although you’! need to 
remember to charge up the power 
bank and keep an eye on its levels. 
The most ingenious thing about 
the Piper, though, is that you can 


carry all the electronics pieces, 
speaker, and mouse inside the 
laptop. It’s not really so much of a 
laptop as a digital toy chest, with 
all your Power Rangers (buttons) 
and Barbies (jumper wires), and 
whatever kids actually play with 
these days (Star Wars figures?) 
kept inside, latched up and ready 
to take with you wherever you go. 
The only thing it’s really missing is 
a carry handle, although we really 
wouldn’t want to be swinging it 
around with loads of bits inside. 
The initial instructions take you 
as far as getting the case built, 
and the Raspberry Pi and screen 
working. Plug it all into the battery 
pack and you boot up into the 
Piper’s OS. This starts with a fun 
little video before launching you 
into the Minecraft adventure that 
helps you continue to build your 
laptop, adding the extra buttons 
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and such via the GPIO. Witha 
couple of hitches you can see 
some of the seams, moments of 
a desktop before the actual game/ 
earning software is launched 

etc. It?s very much running on 
Raspbian, but you’ ll never see 

it through normal use. 


Know your craft 

PiperCraft is the name of this 
game, a modded Minecraft Pi 

that gives you challenges to 
complete and in the process 
teaches you some real-world 
physical computing. Each section 
is presented by machinima-style 
cut scenes, presumably filmed in 
full Minecraft, which are also fully 
voiced in an adorable fashion. 
Guide PiperBot to save Earth from 
Mars, with only a witty assistant 
and many Minecraft blocks to help 
you. There are multiple levels and 
apparently more are being made, 
which will be free to download as 
they become available; people can 
also create levels and share them. 
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It’s all very cute and quaint and 
honestly not like much we’ve seen 
before; CEED Universe on pi-top is 
similar, but also unique in its own 
way beyond just being ‘gamified 
computing education’. 

Let’s return to the concept of 
it as a laptop, though. As we’ve 
said before, the version you’re 
supposed to build and play with is 
not really a proper Pilaptopina 
traditional sense. You don’t have 
a keyboard, for starters. However, 
it can easily be modified to bea 
more normal laptop. You can take 
out the Piper SD card and make a 
normal Raspbian one for yourself. 
The screen connects via HDMI, 
so it doesn’t require any extra 
software to get running. And if 
you take out the little component 
chest and the breadboard, there’s 
enough space to store a little USB 
or Bluetooth keyboard within the 
case. The version that’s shipping 
to consumers will come with a Pi 


PIPER 


£230 /$299 


3 so you can connect to wireless, 
so really it’s very little effort to do 
a ‘conversion’ if you wish. 

It’s a really fun, excellent kit. 
The build, the game, and the 
possibilities for it are great, even 
if it’s perhaps more suitable for 
younger kids than the ‘all ages’ 
for which it’s being marketed. 


{ast word 


The price may be a little 
steep, but it’s a really fun 
educational computer kit 
that should really impress 


those who love Minecraft and 
building stuff. You can also 
take it almost anywhere! 


The box it comes in is 


lovely and compact, 


with everything neatly 


arranged inside. 


There are many parts, 


but they're easy 
to differentiate 
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RASPBERRY PI 
BESTSELLERS 


The best of this summer's Packt Python 
books promise you an autumn of learning 


MODULAR 
PROGRAMMING 
WITH PYTHON 


Author: Erik Westra 
Publisher: Packt 
Price: £25.99 

ISBN: 978-1785884481 
magpi.cc/2aUBKho 


Get organised with this succinct 
guide to making your code 
modular, which takes in Python's 
extensive import system, 

testing your modules, and even 
preparing your modular code for 
sharing on GitHub. 


MASTERING 
IPYTHON 4.0 


Authors: Thomas Bitterman 
Publisher: Packt 

Price: £31.99 

ISBN: 978-1785888410 
magpi.cc/2aUC5QZ 


Get interactive with IPython, not 
just as a rich workbook interface 
to scientific computing, but for 
developing for parallel and high- 
performance computing. The 
book covers testing and working 
with R, Julia, and JavaScript. 


PYTHON: 
REAL-WORLD 
DATA SCIENCE 


Authors: Dusty Phillips et al. 
Publisher: Packt 

Price: £49.18 

ISBN: 978-1786465160 


thon 
magpi.cc/2aUBZsl with Py 


science 


Packt’s comprehensive curated 
course combines works to give 
you 1,250 pages of intensive data 
science learning and practical 
Python coding, taking in NumPy, 
Matplotlib, Redis, and MongoDB 
along the way. 
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BUILDING THE 
WEB OF THINGS 


Author: Vlad M Trifa & 


Dominique D Guinard j, bing 
Publisher: Manning 1) web 
| . of 


ISBN: 978-1617292682 
magpi.cc/2aVEsTC 


Price: £21.99 th 1 ngs 
Competing 
standards and 
fragmentation - IT’s traditional 
curse - have led to the Internet of 
Things (IoT) being more a collection 
of isolated Intranets of Things. 
Guinard and Trifa’s solution is to 
integrate the fragmented parts with 
the most successful application 
layer of them all, the web, using its 
loose coupling and simply defined 
programming model as the basis of 
clean web APIs to build a scalable 
Web of Things (WoT). 

The book, accessible to anyone 
with basic programming and 
web skills, is split into two parts. 


DESIGNING 

FOR SCALABILITY 
WITH ERLANG/OTP 
| Ces = 


Scalability w; 
Erlang/ O a ae 


Author: Steve Vinoski 
& Francesco Cesarini 
Publisher: O'Reilly 
Price: £33.50 

ISBN: 978-1449320737 
magpi.cc/2aUDTta 


Writing this asa 
sequel to O’Reilly’s 
Erlang Programming, veterans 
Cesarini and Vinoski deliver the 
ideal next step to anyone who’s 
completed any introductory work 
on the language and is ready to 
tackle a project that demands 
the distributed language’s key 
benefits: scalability, reliability, 
and availability. 

The introduction helps to define 
the problem space, and the tools 
and libraries available, as well as the 
principles of the OTP environment. 
It’s followed by an Erlang refresher, 
or an introduction for those brave 
enough to start their Erlang journey 
here. Next, design patterns and 


Francesc Cesare & Steve'y 


The first introduces the basics: 
the concept, a device to work on 
(enter the Raspberry Pi), and using 
JavaScript and Node.js to glue 
things together. A hands-on 
walkthrough in chapter two 
gets readers comfortable with 
using the Pi as a remote, web- 
connected device. 

The second section also 
combines the theoretical and the 
practical, as APIs and protocols 

are introduced then used to build 
interactive WoT projects, and the 
reader is drawn from data security 
to scalable physical mash-ups 

of devices. As long as competing 
IoT devices and networks can be 
interacted with through the web, 
at least through some gateway, all 
things are possible. This will ready 
you for tomorrow, while others are 
still arguing over standards. 


Score 


behaviours: client server examples 
are developed, broken into parts, 
packaged into library modules, and 
migrated to OTP-based generic 
server behaviour. Then it 
tackles finite-state machines 
and event handlers, 
using a straightforward 
telephony example. 

Next, there’s monitoring 
and handling errors with 
supervisors, packaged 
“* into the building blocks of 

applications, and then non- 
standard behaviours and building 
robust applications. This is hard 
going for readers, as something 
of a shift in thinking is involved 
to turn out programs in sucha 
form, but this book will help you 
understand the whys and hows of 
OTP. Treating the full trade-offs 
of developing, deploying, and 
working with code in scalable, 
distributed applications makes 
up a very useful final section. 


Score 
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THE CS 
DeLee 


jeremy kubsce 


Author: Jeremy Kubica 
Publisher: No Starch 
Price: £12.99 

ISBN: 978-1593277499 
nostarch.com/searchtale 


“Meet Frank 
Runtime. Disgraced 
ex-detective. 
Hard-boiled private eye. Search 
expert.” Search expert? Yes, 
Runtime uses search algorithms, 
in a novel designed to introduce 
computational thinking to a wider 
audience. Although most useful to 
learner programmers of all ages 
- each chapter ends with lecture 
notes on the concepts covered 
therein - the detective stories are 
entertaining enough to stand on 
their own for anyone who’ll get 
some of the references. 

Runtime, the loner who doesn’t 
follow the rules, is a familiar figure 


ASP.NET CORE 1.0 
HIGH PERFORMANCE 


Author: James Singleton 
Publisher: Packt 

Price: £34.99 

ISBN: 978-1785881893 
magpi.cc/2aUG4x2 


4 


Hoh Prorman 
From ‘Why 
Performance is a 
Feature’, the first chapter, 

this is a book that encourages caring 
about how your code performs, 

to the ultimate benefit of the end 
user, using profiling to eliminate 
bottlenecks in C# applications 
on MS’s latest web application 
framework. Singleton’s introduction 
to getting the best performance on 
.NET Core 1.0 is not your average 
web application development 
book; performance implications of 
architecture are weighed, with the 
Raspberry Pi explicitly considered. 
Yes, the Pi running .NET, and not 
necessarily with Mono. 
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= ay Agora 
tere of 
panphracy, ot 
vampursetor 


in fiction, and a Sam Spade-style 
gumshoe in a pre-industrial world 
is found everywhere from the 1999 
computer game Discworld Noir, to 
Lindsey Davis’s ancient 
Roman detective Falco. 
The key to making it work 
is to keep the humour light 
and the prose terse, which 
Kubica does. Take a look at 
his popular Computational 
Fairy Tales blog if you’d like 
a preview of his style. 
Thanks to courses like 
Police Procedures and Data 
Structures, Runtime is able to 
find the best search algorithm, 
everything from best-first and 
depth-first search, to iterative 
deepening, parallelising, and 
binary search, is covered in this 
entertaining and educational 
read that should give you enough 
background to pursue your 
learning further. 


eke, 


Score 


.NET Core, unlike traditional 
Microsoft products, is open-source 
and cross-platform. In the spirit of 

this, it?s not an MS-centric 

book; other platforms (Mac, 

Linux, and of course the Pi), 

other services (RabbitMQ 
recommended as far better 
than Microsoft Message 
Queuing), and other tools are 
given a fair examination, and 
many so-called ALT.NET choices 
are recommended for working 
with the new ASP.NET. 

After measuring, optimising, 
and even searching for bottlenecks 
in the network stack, the author 
gives a good look at the downsides 
of your improvements: there are 
always trade-offs, and the burden of 
managing complexity and caching 
and debugging issues is considered. 
Essential reading for anyone working 
with ASP.NET Core 1.0. 


Score 


BOOKS 


ESSENTIAL READING: 


PROCESSING 


Learn to code with the open-source 
language designed for the visual arts 


Make: Getting Started 
with Processing 


Author: Casey Reas & Ben Fry 
Publisher: Maker Media 
Price: £17.99 

ISBN: 978-1457187087 
magpi.cc/2aUHSpE 


Very highly regarded introduction to 
working with Processing, teaching core 
programming concepts to coding newbies. 


The Sparkfun Guide 


to Processing THE SPARKEUN 


GUIDE T 
ING 
Author: Derek Runberg poe cm 
Publisher: No Starch 
Price: £21.50 


ISBN: 978-1593276126 
nostarch.com/sparkfunprocessing 


Project-based intro that oozes 
creativity, supported by a strong 
educational framework. 


Learning Processing 
2nd Edition 


Author: Daniel Shiffman 
Publisher: Morgan Kaufmann 
Price: £30.99 

ISBN: 978-0123944436 
learningprocessing.com 


Well-regarded and comprehensive 
intro, updated for compatibility with 
Processing 3 with new chapters on video, 
sound, data visualisation, and networking. 


Welcome to Processing 3 


Author: Daniel Shiffman i =z 
Publisher: N/A 

Price: Free 

ISBN: N/A 
vimeo.com/140600280 


Inspiring look at what's new in a 
Processing 3 (more online resource iin 


are linked from processing.org). 


Processing: A Programming 
Handbook for Visual Designers 
Author: Casey Reas & Ben Fry 

Publisher: MIT Press 

Price: £55.95 

ISBN: 978-0262028288 
magpi.cc/2aUL2d4 


Covering Processing 2.0 and 3.0, and 
updated for the new syntax, the definitive 
reference from Processing's co-founders. 
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Community 


THE MONTH IN 
RASPBERRY PI 


Everything else that happened this month in the world of Raspberry Pi 


8. RATCHET - Lat 


© © mL, ’ 


SPACE SCIENCE 


Here's two more experiments from the recently 
ended Astro Pi mission. View them here: 
magpi.cc/2bjxXogw 


RADIATION 


Using image recognition software, the Radiation 
experiment covered the camera lens so that visible 
light couldn't get through. Radiation was, however, 
able to hit the sensor and create flashes on the 
sensors which can be observed. Unfortunately, due to 
the thickness of the flight case, the results were a little 
less than the team had hoped for. They are trying to 
decipher the data they have, but there may have been 
some damage to the camera during operation. 


Astro Pi ISS radiation experiment events 07/03/2016 - 14/03/2016 


Suspected ionising 
events 


Pixels subtracted 


nun oii ' rat 
WT LT Steaa repressct nut 
Wi Lo | | | of pixels affected in image 
Measurements were taken 
every 6 seconds 
| 
q | 


naldson, Gopnathan, Gunasekera 


Red 


FLAGS 


As the ISS flies high above the Earth, it passes over 
many countries, sometimes very quickly. Flags was 
programmed to show what country the ISS was 

currently over, by displaying that country’s flag and 


wo issues ago we published our Astro Pi special, 
where we covered some of the results from 
the experiments performed by code written by 
schoolkids, for use on the International Space Station 
(ISS) by British ESA astronaut Tim Peake. 
We really only scratched the surface with the 


a short phrase in its language. Unfortunately, by 
the time the code went up to space, minor course 
corrections on the ISS made the code out of date. 
However, Tim fixed it in his spare time and it started 


results we were able to show off within the confines j i : 

of the magazine. Fortunately, they are all now erroving the correct counties \agaltl 

available for people to view online on the Astro Pi 

website: magpi.cc/2bjXogW. mission update on the Raspberry Pi website. While 
“One of the main things we’ve learnt from running __ this brings to an end the Astro Pi mission as it was 

Astro Pi is that the biggest motivational factor for originally set out, there’s still a bright future for 

young people is the very tangible goal of having their Astro Pi: it will be used by other ESA countries with 

code run in space,” Dave Honess writes in his blog their own competitions in the future. Read issue 47 of 


post (magpi.cc/2bv27rF) detailing the ninth Astro Pi The MagPi to find out more. 
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CROWDFUND | 


THIS! 


The best crowdfunding hits this 
month for you to check out... 


Raspberry pi CASE 
Digital Photos with a 1965 Camera 


Oo 
I'm Back” 


I'M BACK 


THIS MONTH IN Pl 


iN A 


WITH ICE CREAM 


eae 


t’s not a very descriptive name, but at its simplest it’s a 
case for the Raspberry Pi inspired by the US and UK version 
of the NES games console. The pitch revolves around using 


it to play classic games, presumably via RetroPie. To this 
kck.st/2aDOYdR 
end, the case has been arranged so that you can access the 


Yes, that’s its name. This is one of the most unusual 
projects using the Raspberry Pi that we’ve seen for a 
while: it’s a special case for the Pi which allows you to 
attach an old 35mm camera, and use the lens and such 
to take photos using a Pi Camera Module. We think it’s 
a remarkable idea, and clearly a lot of people agree: it’s 
already funded and the campaign is just a few days old. 
If you want to meld classic photography with modern 
digital photography, give it a look. 


THE VILLAGE PC PROJECT 


This campaign is aimed towards sending 100 
Raspberry Pi computer kits, including a screen and 
input devices, to different villages around Cambodia 
so that the kids there have a chance to learn about 
computing. They’re not just sending computers, 
though: the goal of the project is also to send people to 
help teach the kids and the schools about computing, 
so that they can have a bit of a head start with it. They 
hope to help several hundred disadvantaged kids 
living in rural Cambodia with this project. 


raspberrypi.org/magpi 


SD card slot from the lid, and four USB ports have been 
installed on the front of the console so you can connect 
controllers; the standard Pi USB ports are on the back. 


BEST OF THE REST 


SMART 
SHOE RACK 


ALTOIDS 
COMPUTER 
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The monthly MagPi 
magazine selfie has become 
standard on Twitter 

Zach was one 


of several young makers on 
the Young Person's Panel 
at this year’s Raspberry Pi 
4th Birthday Bash 


: 
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The 16-year-old, piano-wielding, 
Pi-building entrepreneur looking to educate 
the world on the importance of tech 


ou may recognise the 

name Zachary Igielman 

from issue #38, where 
he was mentioned during our 
review of the exciting Pimoroni 
Piano HAT. The Piano HAT, for 
those unaware, was inspired by 
Zach’s own creation, the PiPiano, 
a successful crowdfunded add-on 
board that hit 184% of funding 
two years ago. At age 14, Zach 
had decided to incorporate his 
passions for making, engineering 
and music, building himself 
a PCB that could use physical 
keys to control electronic sound 
files and Sonic Pi code. The 
PCB, he explains, is a great 
classroom tool, educating 


students on the fundamentals 
of physically building digital 
tech and soldering, through to 
understanding sound generation 
through PWM frequencies. 
Zach began to teach himself 
ode at age 11, soon discovering 
the Raspberry Pi and, later, the 
Cambridge Raspberry Jams. It was 
through this collective of like- 
minded individuals that Zach was 
inspired to broaden his making 
skills, moving on to create line- 
following robots that avoided 
objects through sensors. 
Moving forward, Zach visited 
the Raspberry Pi offices for 
work experience, continuing to 
work on and study robots and 


@) 
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robotic guides, working alongside 

our engineers to build upon 

his knowledge. 
It was around this same time, 

in October 2014, that Zach 

met Frank Thomas-Hockey 

via Twitter. Frank was looking 

for help in creating the first 

London Raspberry Jam and Zach 


At 16, Zach has already made 
major contributions to the Raspberry Pi 
community and beyond 


built a fast friendship online, 
lovingly referring to him asa 
fellow “computer geek”. The 
two have worked on projects 
together, including several 
websites, and spent time 


Zach began to teach 
himself code at age 11, soon 
discovering the Raspberry P1 


was more than willing to lend 
a hand. Between them, they 
set up the Covent Garden Jam, 
welcoming over 100 visitors to 
their first event. Their most recent 
Jam — now with the additional 
help of volunteers Ben, Paul, 
and Joseph — allowed them to 
simultaneously run workshops on 
soldering, Sonic Pi and Minecraft, 
while also highlighting maker 
projects through show-and-tell 
and talks. 

Finally finished with his 
GCSE exams and about to begin 
his sixth-form studies in Maths, 
Further Maths, Physics and 
Computing, Zach now has the 
time to continue his recent 
collaboration with friend Jake 
Blumenow. Zach met Jake and 
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travelling, bouncing ideas off one 
another with the aim to create 
something important. It’s their 
most recent venture that is worthy 
of recognition. 

“At Google Campus, we 
developed our business model 
— we believe people of all ages 
have the right to understand how 
the technological world around 
us works so they can modify and 
create their own technology.” 
Between the two of them, they 
aim to create complete Raspberry 
Pi education kits, inviting 
beginners in making and coding to 
create functional projects, such as 
an alarm system, thus cementing 
the pair’s desire to highlight the 
day-to-day importance of tech 
in out lives. 
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RASPBERRY \: 
JAM 
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HULL RASPBERRY JAM 

When: Saturday 10 September 

Where: Malet Lambert School, 
Hull, UK 

magpi.cc/2bcgofO 

An event to bring people 

together and discover the 

exciting possibilities 

of Raspberry Pi. 


CORNWALL TECH JAM 

When: Saturday 17 September 

Where: Pool Innovation Centre, 
Pool, UK 

magpi.cc/2bmRKW8 

Come along and celebrate 

Software Freedom Day, for anyone 

of all ages and abilities interested 

in technology. 
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RARITAN HIGH SCHOOL 

RASPBERRY JAM 

When: Saturday 17 September 

Where: Raritan High School, 
Hazlet, NJ, USA 

magpi.cc/2bmRIxx 

Helping beginners and those 

interested in the Pi to exhibit any 

projects, create, and share ideas. 


TORBAY TECH JAM 

When: Saturday 17 September 

Where: Paignton Library and 
Information Centre, 
Paignton, UK 

magpi.cc/28KHI18v 


Fun, informal, and family-friendly. 


Aims to inspire people to get into 
code and take up STEM subjects. 
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RASPBERRY JAM BOGOTA 

When: Saturday 17 September 

Where: Avenida El Dorado Carrera, 
Bogota D.C., Colombia 

magpi.cc/28Kavk3 

Following on from July’s first ever 

South American Raspberry Jam 

is the third Jam in Colombia’s 

capital city, Bogota. 


RASPBERRY JAM 

PRESTON 

When: Monday 3 October 

Where: Media Innovation Studio, 
Preston, UK 

magpi.cc/2bmQZfA 

Learn, create, and share the 

potential of the Raspberry Pi 

at a family-friendly event. 


raspberrypi.org/magpi 


@ RASPBERRY JAM LEEDS 


@ HULL RASPBERRY JAM 


RASPBERRY JAM 
IPSWICH 
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RASPBERRY JAM LEEDS 

When: Wednesday 5 October 

Where: Swallow Hill Community 
College, Leeds, UK 

magpi.cc/2bmQXEI 

Everyone is invited for a couple 
of hours of computing fun, 

7 talks, demonstrations, and 


hands-on workshops. 


DON'T MISS: 


When: Saturday 17 September Where: Pool Innovation Centre, Pool, UK 


There are many Jams to choose 

from on 17 September, as it's also 

being celebrated as Software 

Freedom Day. Cornwall Tech Jam 

offers a wide variety of activities, 

not just Raspberry Pi-based, that G 
involve STEM subjects, coding, and 
other forms of tech. There'll be seep @ 
plenty of helpinterms of learning —seseat_ oa 
to code in Python and Scratch, é 
as well as being able to hack 
Minecraft Pi. You can find out more 
information on the event's page I i 
here: magpi.cc/2bmRKW8 | 


RASPBERRY JAM 

IPSWICH 

When: Saturday 8 October 

Where: University Campus Suffolk, 
Ipswich, UK 

magpi.cc/2bcigVI 

Join the growing community 

and learn how to make cool 

gadgets and how to code. 
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The Sense 
HAT, as used 
in the Astro Pi; 
there’s now an 
emulator for it 
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The Raspberry Pi 3's Compute Module will be very 


developer-friendly when it’s released 


Technical specifications 


I need to obtain a more detailed specification sheet for 
the Raspberry Pi 3 B for a project I’m working on. The 
requirement I have is specifically to determine what 
voltage tolerance the PC interface has (i.e. minimum 
and maximum voltage). Do you have access to one or 
do you know what it is at all? Hope you can help! 


Andrew Linahan 


We reached out to the people who work on Raspberry Pi 


hardware about the tech specs, and they told us some 
were on the way for when the Compute Module 3 is 
properly released. You may remember that duri 


Raspberry Pi 3 announcement back i 


Upton also announced an updated Computer Module 


which would use the same hardware 
Pi 3, specifically the BCM2837 chip. 1 


n February 


as the Ras 
[The numbe 


need, and much more info, will be available on 
sheet when it becomes available; keep an eye 0 


social channels and blogs for when i 
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Community 


FROM THE FORUM: 
BOOK REVIEWS 


The Raspberry Pi Forum is a hotbed of conversations and problem-solving 
for the community - join in via raspberrypi.org/forums 


published a free book on the Raspberry 

Pi family which is available for everyone 

to download. I’m wondering if it could be 
submitted for review within The MagPi magazine? 
Is there a process for submission? 


kolban 


When it comes to book reviews, we obviously 
have the two-page spread at the end of the review 
section, and we’re always happy to hear about 
books that might belong in there. The easiest way 
to let us know about a book you might want us to 


Which Pi Zero is which? 

Hi there, MagPi! I’ve been reading you online for ages 

now and really enjoying the magazine, and I thought 

what better way to support you and the Raspberry 

Pi Foundation than to subscribe to the magazine, 

especially with such an attractive subs offer going on! 
I did just want to check with you what version of 

the Pi Zero you get in the subscription. Is it the new 

v1.3 one that has a camera connector, or the original 

Pi Zero? I’ll probably get it anyway, but I did just 

want to check! 

Ken B. 


We actually get asked this question a lot and 

we’re always happy to confirm that yes, the new 
subscription offer comes with a brand new, free Pi 
Zero v1.3 with the added camera connector. Just to 
remind everyone else reading, the offer also gets 
you an HDMI adapter, a USB adapter, and the cable 
required to attach both versions of the Pi Camera 
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look at is to email us at magpi@raspberrypi.org and 
we’ll get back to you about it. Usually it’s as simple 

as us Sending it to our book reviews man Richard 
Smedley so he can add it to his pile for reviews, but we 
can always work out the details through email. 


WRITE TO US 


Have you got something you'd like to say? 
Get in touch via magpi@raspberrypi.org or on The MagPi 
section of the forum at: raspberrypi.org/forums 


44 
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Module to the Pi Zero. It’s open to people taking out 
six- and 12-month subscriptions of the print version 
of the magazine, and we’ll ship worldwide as well. 
You can check out our subs at magpi.cc/Subs1. 


Above Subscribe 
today to get the 
offer straight 

to your door 

and never miss 
another issue 
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READ US 


LEARN TO 
SAVE \ CODE WITH 


ALL NEW RASPBERRY PI GETTING STARTED GUIDE SCRATCH 


with a Newsstand WITH OUR NEW 


‘oti Renpberry PL mogaine REE ORE pat sa subscription 


(limited time offer) 
BUILD A FOOTBALL 
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RASPBERRY PI & | AVAILABLE ON 
BEGINNER’ SGU IDE iw THE MAGPI APP! 
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£2.29 ° £26.99 


Magazine rolling subscription full year subscription 


Download it today - it’s free! 


Get all 30 legacy issues free 
for smartphones & tablets 


Instant downloads every month 


Google Pla gf ae 
ad aPPOtole > y Y Live links & interactivity 
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Terms & Conditions 

Competition closes 26 September 2016. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Column | THE FINAL WoRD 


MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


‘BEYOND 
» THE BOOKCASE 


Matt Richardson explores Raspberry Pi’s role in 


efore I became a part of the maker movement, 
my impression of a library was mostly formed 
by my childhood experiences there. Both my 
school and local public library were places for books, 
magazines, newspapers, and research. In short, it 

was a place for quiet reading. Libraries today look 

and sound a lot different than I remember. Many now 
include makerspaces, tools for connected learning, 
and spaces for community gathering. 

But if you take a closer look at what these 
institutions set out to accomplish in the first place, 
then the reason they’ve transformed becomes clear. 
Take, for instance, the mission of the Seattle Public 
Library, which is to “{bring] people, information, and 
ideas together to enrich lives and build community.” 
The mission of the library isn’t directly related to 
reading, even though reading can be a big part of 
achieving that mission. 

A few years ago, I had the opportunity to visit the 
central branch of the Seattle Public Library. The 
fifth floor is called ‘The Mixing Chamber’ and isa 
designated location where people, information, and 
ideas can come together. Of course, there’s plenty 
of material to read at the main branch of the Seattle 
Public Library, but this building in particular makes it 
very clear that they’re about more than just reading. 

As another indication of this, we see a lot of interest 
in Raspberry Pi from librarians. A group of us recently 
visited the annual conference of the American Library 
Association in Orlando, and the reaction to our 
presence there was incredibly positive. Not only have 
many librarians heard of Raspberry Pi, but they also 
use it in So many ways. 

Of course, library makerspaces use Raspberry Pi 
just like any other makerspace would: as a platform 
for DIY projects. There are even many libraries that 
create Raspberry Pi checkout kits so that their patrons 
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the transformation of libraries in the digital age 


can experiment with Raspberry Pi in their own time, 
either in the library or at home. 

And just as Raspberry Pi is used in the classroom 
to learn about computing, it’s also being used in the 
library for the very same reason. We’ve had many 
librarians come to our Picademy educator professional 
development programme to learn about teaching 
people with digital making and computing. These 
librarians have gone on to share their knowledge and 
our learning resources with their patrons. Librarians 
especially love that our content, including this very 
magazine, is available online entirely for free and is 
Creative Commons licensed. 


Multitasking 
What I especially like about the librarians I’ve 
encountered is that they don’t just put Raspberry 
Pi in the hands of their patrons, but they use our 
computers as a tool for their own work. For instance, 
I recently met Richard Loomis from the Somerset 
County Library System in New Jersey. He uses 
Raspberry Pis for networked digital signage across 
a few different branches. And John Jakobsen from 
the Palos Verdes Library District recently shared 
how he set up Raspberry Pis as terminals for their 
public access catalogue, replacing old and expensive 
computers. So librarians don’t just talk the talk: they 
also walk the walk. 

I’m optimistic that libraries will continue to 
thrive as technology changes. At the Raspberry Pi 
Foundation, we’re delighted to see that libraries all 
over the world use our computers for digital making, 
education, and utility. Our organisation’s connection 
with libraries will always be rich and meaningful, not 
only because of the way they use Raspberry Pi, but 
because we have something critical in common with 
them: we deeply value accessibility and community. 
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Raspberry Pi gets a home 
extension 


Endless expansion possibilities with Raspberry Pi 

The new RPI-BC enclosure is designed specifically to accommodate Raspberry Pi 
computers. The DIN rail or wall mountable enclosure provides access to all ports, 
GPIO pins and SD card without removing the lid. RPI-BC is part of the BC portfolio 
of electronics enclosures from Phoenix Contact. 


For additional information call 0845 881 2222 or visit phoenixcontact.co.uk/rpibc 
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HACKING & MAKING 
[IN MINECRAFT 


Get started today for CODE VIRTUAL WORLDS 
just £2.99 / $3.99 von Raspberry Pi 


The 


® From the makers of the 
| official Raspberry Pl magazine 


4 Available on the GET IT ON 


@ AppStore | | D> Google Play Find it on 
Ua, @ 

agPi 

perieaees digital app 


CHAPTER 


GETTING STARTED | Magri 
WITH MINECRAFT: HACKING 
PI EDITION eee 


Get off to a good start with Minecraft: Pi Edition. Play 
the game and write your first program using the API 


A 


magpi.cc/Minecraft-book 
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Serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout Pi Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Differential P| 


8 channel 18 bit analogue to digital 
converter. |?C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


AIG Pi Plu 


Real-time clock with battery backup 
and 5V IC level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


1 Wire Pi Plus 


1-Wire® to I?C host interface with ESD 
protection diode and |?C address 
selection. 


electronics 


Now 
Available 
for the 
Pi Zero 


SAVE 


15% 


“MagPi15” 


discount code 


GoPiGo 


Everything you need to 
build a Raspberry Pi robot! 


a | —~ ; 
yy -* 4 a i Fs B 
i y | J CC re 
= 


Vi 
ot | a | | 
: CRs > Connect hundreds of sensors 
6 ei = to your Raspberry Pi: 
6 


$89 / £59 


